이 리소스를 사용하려면 다음 단계를 따르세요:
- 저장소 포크하기:
버튼을 클릭하세요.
- 저장소 클론하기:
git clone https://github.com/microsoft/mcp-for-beginners.git - Azure AI Foundry Discord에 참여하여 전문가 및 다른 개발자들과 교류하기
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Korean | Malay | Marathi | Nepali | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Thai | Turkish | Ukrainian | Urdu | Vietnamese
**모델 컨텍스트 프로토콜(MCP)**은 AI 모델과 클라이언트 애플리케이션 간의 상호작용을 표준화하기 위해 설계된 최첨단 프레임워크입니다. 이 오픈소스 커리큘럼은 C#, Java, JavaScript, TypeScript, Python 등 인기 있는 프로그래밍 언어를 활용한 실습 코딩 예제와 실제 사용 사례를 포함한 체계적인 학습 경로를 제공합니다.
AI 개발자, 시스템 아키텍트, 소프트웨어 엔지니어 등 누구든 MCP의 기본 원리와 구현 전략을 마스터할 수 있는 종합적인 리소스입니다.
- 📘 MCP 문서 – 상세 튜토리얼 및 사용자 가이드
- 📜 MCP 명세 – 프로토콜 아키텍처 및 기술 참조
- 📜 기존 MCP 명세 – 레거시 기술 참조 (추가 세부 정보 포함 가능)
- 🧑💻 MCP GitHub 저장소 – 오픈소스 SDK, 도구 및 코드 샘플
- 🌐 MCP 커뮤니티 – 토론에 참여하고 커뮤니티에 기여하세요
| 모듈 | 주제 | 설명 | 링크 |
|---|---|---|---|
| 모듈 1-3: 기본 개념 | |||
| 00 | MCP 소개 | 모델 컨텍스트 프로토콜과 AI 파이프라인에서의 중요성 개요 | 자세히 보기 |
| 01 | 핵심 개념 설명 | MCP 핵심 개념에 대한 심층 탐구 | 자세히 보기 |
| 02 | MCP 보안 | 보안 위협 및 모범 사례 | 자세히 보기 |
| 03 | MCP 시작하기 | 환경 설정, 기본 서버/클라이언트, 통합 | 자세히 보기 |
| 모듈 3: 첫 번째 서버 및 클라이언트 구축 | |||
| 3.1 | 첫 번째 서버 | 첫 MCP 서버 만들기 | 가이드 |
| 3.2 | 첫 번째 클라이언트 | 기본 MCP 클라이언트 개발 | 가이드 |
| 3.3 | LLM 클라이언트 | 대형 언어 모델 통합 | 가이드 |
| 3.4 | VS Code 통합 | VS Code에서 MCP 서버 사용 | 가이드 |
| 3.5 | stdio 서버 | stdio 전송을 사용하는 서버 생성 | 가이드 |
| 3.6 | HTTP 스트리밍 | MCP에서 HTTP 스트리밍 구현 | 가이드 |
| 3.7 | AI 툴킷 | MCP와 함께 AI 툴킷 사용 | 가이드 |
| 3.8 | 테스트 | MCP 서버 구현 테스트 | 가이드 |
| 3.9 | 배포 | MCP 서버를 프로덕션에 배포 | 가이드 |
| 모듈 4-5: 실습 및 고급 주제 | |||
| 04 | 실습 구현 | SDK, 디버깅, 테스트, 재사용 가능한 프롬프트 템플릿 | 자세히 보기 |
| 05 | MCP 고급 주제 | 멀티모달 AI, 확장, 엔터프라이즈 활용 | 자세히 보기 |
| 5.1 | Azure 통합 | MCP와 Azure 통합 | 가이드 |
| 5.2 | 멀티모달 | 여러 모달리티 작업 | 가이드 |
| 5.3 | OAuth2 데모 | OAuth2 인증 구현 | 가이드 |
| 5.4 | 루트 컨텍스트 | 루트 컨텍스트 이해 및 구현 | 가이드 |
| 5.5 | 라우팅 | MCP 라우팅 전략 | 가이드 |
| 5.6 | 샘플링 | MCP에서 샘플링 기법 | 가이드 |
| 5.7 | 확장 | MCP 구현 확장 | 가이드 |
| 5.8 | 보안 | 고급 보안 고려 사항 | 가이드 |
| 5.9 | 웹 검색 | 웹 검색 기능 구현 | 가이드 |
| 5.10 | 실시간 스트리밍 | 실시간 스트리밍 기능 구축 | 가이드 |
| 5.11 | 실시간 검색 | 실시간 검색 구현 | 가이드 |
| 5.12 | Entra ID 인증 | Microsoft Entra ID로 인증 | 가이드 |
| 5.13 | Foundry 통합 | Azure AI Foundry와 통합 | 가이드 |
| 5.14 | 컨텍스트 엔지니어링 | 효과적인 컨텍스트 엔지니어링 기법 | 가이드 |
| 모듈 6-10: 커뮤니티 및 모범 사례 | |||
| 06 | 커뮤니티 기여 | MCP 생태계에 기여하는 방법 | 가이드 |
| 07 | 초기 도입에서 얻은 통찰 | 실제 구현 사례 | 가이드 |
| 08 | MCP 모범 사례 | 성능, 장애 허용, 복원력 | 가이드 |
| 09 | MCP 사례 연구 | 실제 구현 예제 | 가이드 |
| 10 | 실습 워크숍 | AI 툴킷으로 MCP 서버 구축 | 랩 |
| 언어 | 설명 | 링크 |
|---|---|---|
| C# | MCP 서버 예제 | 코드 보기 |
| Java | MCP 계산기 | 코드 보기 |
| JavaScript | MCP 데모 | 코드 보기 |
| Python | MCP 서버 | 코드 보기 |
| TypeScript | MCP 예제 | 코드 보기 |
| Rust | MCP 예제 | 코드 보기 |
| 언어 | 설명 | 링크 |
|---|---|---|
| C# | 고급 샘플 | 코드 보기 |
| Java with Spring | 컨테이너 앱 예제 | 코드 보기 |
| JavaScript | 고급 샘플 | 코드 보기 |
| Python | 복잡한 구현 | 코드 보기 |
| TypeScript | 컨테이너 샘플 | 코드 보기 |
이 커리큘럼을 최대한 활용하려면 다음을 준비해야 합니다:
-
C#, Java, JavaScript, Python, 또는 TypeScript 중 하나 이상의 언어에 대한 기본 프로그래밍 지식
-
클라이언트-서버 모델과 API에 대한 이해
-
REST와 HTTP 개념에 대한 친숙함
-
(선택 사항) AI/ML 개념에 대한 배경 지식
-
지원을 위한 커뮤니티 토론 참여
이 저장소에는 효과적으로 학습하고 탐색할 수 있도록 돕는 다양한 자료가 포함되어 있습니다:
포괄적인 학습 가이드가 제공되어 이 저장소를 효과적으로 탐색할 수 있도록 도와줍니다. 가이드에는 다음이 포함됩니다:
- 다루는 모든 주제를 보여주는 시각적 커리큘럼 맵
- 각 저장소 섹션에 대한 상세한 설명
- 샘플 프로젝트를 사용하는 방법에 대한 안내
- 다양한 기술 수준에 맞는 추천 학습 경로
- 학습 여정을 보완할 추가 자료
커리큘럼 자료의 모든 주요 업데이트를 추적하는 상세한 변경 로그를 유지합니다:
- 새로운 콘텐츠 추가
- 구조적 변경
- 기능 개선
- 문서 업데이트
이 가이드의 각 레슨에는 다음이 포함됩니다:
- MCP 개념에 대한 명확한 설명
- 여러 언어로 작성된 실시간 코드 예제
- 실제 MCP 애플리케이션을 구축하기 위한 연습 문제
- 고급 학습자를 위한 추가 자료
MCP Dev Days는 AI 모델과 이를 지원하는 도구를 연결하는 새로운 표준인 Model Context Protocol(MCP)에 전념하는 가상 이벤트로, 심도 있는 기술 통찰, 커뮤니티 연결, 실습 학습을 제공하는 이틀간의 행사입니다.
이벤트 페이지에서 등록하여 MCP Dev Days를 시청할 수 있습니다: https://aka.ms/mcpdevdays.
MCP를 개발자 워크플로우에 활용하고 놀라운 MCP 커뮤니티를 축하하는 데 초점을 맞춥니다. Arcade, Block, Okta, Neon과 같은 커뮤니티 멤버 및 파트너와 함께 Microsoft와 협력하여 개방적이고 확장 가능한 MCP 생태계를 형성하는 방법을 살펴봅니다.
- VS Code, Visual Studio, GitHub Copilot 및 인기 있는 커뮤니티 도구를 활용한 실제 데모
- 실용적이고 컨텍스트 중심의 개발 워크플로우
- 커뮤니티 주도 세션 및 통찰
MCP를 처음 접하거나 이미 사용 중인 개발자 모두에게 영감을 주고 실행 가능한 통찰을 제공합니다.
MCP 구축자를 위한 날입니다. MCP 서버를 생성하고 이를 AI 워크플로우에 통합하기 위한 구현 전략과 모범 사례를 심도 있게 다룹니다.
- MCP 서버 구축 및 에이전트 경험에 통합
- 프롬프트 기반 개발
- 보안 모범 사례
- Functions, ACA, API Management와 같은 빌딩 블록 사용
- 레지스트리 정렬 및 도구(1P + 3P)
개발자, 도구 제작자, AI 제품 전략가라면 확장 가능하고 안전하며 미래 지향적인 MCP 솔루션을 구축하는 데 필요한 통찰을 얻을 수 있습니다.
MCP 초급 커리큘럼의 내용을 기반으로 MCP 서버를 생성하고, VS Code와 통합하며, Azure에 전문적으로 배포하는 방법을 집중적인 비디오 세션을 통해 배웁니다. 주요 기업들이 이미 사용 중인 기술에 대한 실질적인 기술을 습득할 수 있습니다.
중요한 코드 샘플을 기여해 주신 Microsoft Valued Professional Shivam Goyal님께 감사드립니다.
이 콘텐츠는 MIT 라이선스에 따라 라이선스가 부여됩니다. 이용 약관은 LICENSE를 참조하세요.
이 프로젝트는 기여와 제안을 환영합니다. 대부분의 기여는 Contributor License Agreement(CLA)에 동의해야 하며, 이를 통해 귀하가 기여에 대한 권리를 보유하고 있으며 실제로 Microsoft가 귀하의 기여를 사용할 권리를 부여한다는 것을 선언합니다. 자세한 내용은 https://cla.opensource.microsoft.com를 참조하세요.
풀 리퀘스트를 제출하면 CLA 봇이 자동으로 CLA 제공 여부를 결정하고 PR에 적절히 표시합니다(예: 상태 확인, 댓글). 봇이 제공하는 지침을 따르기만 하면 됩니다. CLA는 모든 저장소에서 한 번만 제출하면 됩니다.
이 프로젝트는 Microsoft 오픈 소스 행동 강령을 채택했습니다.
자세한 내용은 행동 강령 FAQ를 참조하거나 opencode@microsoft.com으로 추가 질문이나 의견을 보내주세요.
저장소는 다음과 같이 구성되어 있습니다:
- 핵심 커리큘럼 (00-10): 10개의 순차적 모듈로 구성된 주요 콘텐츠
- images/: 커리큘럼 전반에 사용되는 다이어그램 및 삽화
- translations/: 자동 번역을 통한 다국어 지원
- translated_images/: 다이어그램 및 삽화의 현지화된 버전
- study_guide.md: 저장소 탐색을 위한 포괄적인 가이드
- changelog.md: 커리큘럼 자료의 모든 주요 변경 사항 기록
- mcp.json: MCP 사양을 위한 구성 파일
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: 프로젝트 관리 문서
우리 팀은 다른 강좌도 제작합니다! 확인해 보세요:
- AI Agents For Beginners
- Generative AI for Beginners using .NET
- Generative AI for Beginners using JavaScript
- Generative AI for Beginners
- Generative AI for Beginners using Java
- ML for Beginners
- Data Science for Beginners
- AI for Beginners
- Cybersecurity for Beginners
- Web Dev for Beginners
- IoT for Beginners
- XR Development for Beginners
- Mastering GitHub Copilot for AI Paired Programming
- Mastering GitHub Copilot for C#/.NET Developers
- Choose Your Own Copilot Adventure
이 프로젝트에는 프로젝트, 제품 또는 서비스에 대한 상표 또는 로고가 포함될 수 있습니다. Microsoft 상표 또는 로고의 허가된 사용은 Microsoft의 상표 및 브랜드 가이드라인을 따라야 합니다.
수정된 버전의 이 프로젝트에서 Microsoft 상표 또는 로고를 사용하는 경우 혼란을 초래하거나 Microsoft의 후원을 암시해서는 안 됩니다.
제3자 상표 또는 로고의 사용은 해당 제3자의 정책을 따라야 합니다.
면책 조항:
이 문서는 AI 번역 서비스 Co-op Translator를 사용하여 번역되었습니다. 정확성을 위해 최선을 다하고 있지만, 자동 번역에는 오류나 부정확성이 포함될 수 있습니다. 원본 문서의 원어 버전을 권위 있는 출처로 간주해야 합니다. 중요한 정보의 경우, 전문적인 인간 번역을 권장합니다. 이 번역 사용으로 인해 발생하는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다.