mcp-for-beginners

이 저장소는 단일 실행 제품이 아니라 구조화된 학습 자료입니다. MCP를 AI 애플리케이션과 클라이언트가 MCP 서버가 노출하는 도구와 서비스를 호출하는 표준화된 방식으로 소개하며, 초보자 친화적인 설명을 먼저 제공한 뒤 구현으로 진행합니다. 예제는 .NET/C#, Java, TypeScript, JavaScript, Rust, Python을 지원하며, 계산기 형태의 서버와 클라이언트에서 시작해 LLM 연결 애플리케이션으로 발전합니다. 커리큘럼은 모듈로 구성됩니다. 기초 모듈은 MCP 소개, 핵심 개념, 보안을 다루며 위협 지침과 권한 부여 패턴을 포함합니다. 시작하기 섹션에서는 환경 설정, 첫 서버와 클라이언트, LLM 통합, VS Code 사용, stdio 및 HTTP 스트리밍, Microsoft Foundry Toolkit, 테스트, 배포, RBAC 및 간단한 인증, MCP 호스트, Inspector, 샘플링, MCP 앱을 단계별로 안내합니다. 후반 모듈은 실용적인 SDK 사용, 페이지네이션, 디버깅, 재사용 가능한 프롬프트 템플릿, 멀티모달 시나리오, OAuth2, 라우팅, 확장, 고급 보안, 웹 검색, 실시간 스트리밍과 검색, Microsoft Entra ID, Foundry 통합, 컨텍스트 엔지니어링, 사용자 지정 전송, 프로토콜 기능, 다중 에이전트 추론 예제를 다룹니다. 전용 13개 랩 섹션은 PostgreSQL 통합 MCP 서버를 통해 학습자를 안내하며, 아키텍처, 멀티테넌시와 행 수준 보안, Docker 및 Azure 설정, 스키마 설계, FastMCP 구현, 데이터베이스 쿼리 도구, Azure OpenAI와 pgvector를 사용한 시맨틱 검색, 테스트, VS Code 통합, Azure Container Apps 배포, Application Insights 모니터링, 프로덕션 강화를 다룹니다. 추가 자료는 커뮤니티 기여, 도입 교훈, 모범 사례, 사례 연구, 워크숍, Copilot 앱 도구를 다룹니다. README는 공식 MCP 문서, 사양, SDK 저장소, 커뮤니티 토론을 링크합니다. 교육 대상 프로토콜 개정판을 2026-07-28로 명시하며, 무상태 요청과 Extensions 프레임워크를 포함한다고 밝히면서 일부 예제는 SDK 지원이 따라잡는 동안 2025-11-25 버전으로 유지된다고 언급합니다. 이 저장소는 50개 이상 언어로 자동 번역된 자료도 포함하며, 번역 자산 없이 핵심 과정만 클론하기 위한 스파스 체크아웃 명령을 문서화합니다.