이 리소스를 사용하기 위해 다음 단계를 따라주세요:
- 저장소 포크하기: 클릭
- 저장소 클론하기:
git clone https://github.com/microsoft/mcp-for-beginners.git - Azure AI Foundry Discord에 참여하여 전문가 및 개발자들과 교류하기
French | Spanish | German | Russian | Arabic | Persian (Farsi) | Urdu | Chinese (Simplified) | Chinese (Traditional, Macau) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Taiwan) | Japanese | Korean | Hindi | Bengali | Marathi | Nepali | Punjabi (Gurmukhi) | Portuguese (Portugal) | Portuguese (Brazil) | Italian | Polish | Turkish | Greek | Thai | Swedish | Danish | Norwegian | Finnish | Dutch | Hebrew | Vietnamese | Indonesian | Malay | Tagalog (Filipino) | Swahili | Hungarian | Czech | Slovak | Romanian | Bulgarian | Serbian (Cyrillic) | Croatian | Slovenian | Ukrainian | Burmese (Myanmar)
**Model Context Protocol (MCP)**은 AI 모델과 클라이언트 애플리케이션 간의 상호작용을 표준화하기 위해 설계된 최첨단 프레임워크입니다. 이 오픈소스 커리큘럼은 C#, Java, JavaScript, TypeScript, Python 등 인기 있는 프로그래밍 언어를 아우르는 실습 코드 예제와 실제 사례를 포함한 체계적인 학습 경로를 제공합니다.
AI 개발자, 시스템 아키텍트, 소프트웨어 엔지니어 등 누구든지 MCP의 기본 개념과 구현 전략을 마스터할 수 있는 종합 가이드입니다.
- 📘 MCP 문서 – 상세 튜토리얼과 사용자 가이드
- 📜 MCP 명세서 – 프로토콜 아키텍처 및 기술 참고자료
- 📜 원본 MCP 명세서 – 이전 기술 참고자료 (추가 정보 포함 가능)
- 🧑💻 MCP GitHub 저장소 – 오픈소스 SDK, 도구, 코드 샘플
- 🌐 MCP 커뮤니티 – 토론 참여 및 커뮤니티 기여
MCP Dev Days는 AI 모델과 이를 지원하는 도구를 연결하는 신흥 표준인 Model Context Protocol (MCP)에 대한 깊이 있는 기술 인사이트, 커뮤니티 교류, 실습 학습을 제공하는 온라인 행사입니다.
MCP Dev Days는 https://aka.ms/mcpdevdays 에서 등록 후 시청할 수 있습니다. YouTube 또는 Twitch 라이브 스트림에 참여할 수 있으며, 모든 콘텐츠는 녹화되어 Microsoft Developer YouTube 채널에서 다시 볼 수 있습니다. 데모 소스 코드는 GitHub에서도 제공됩니다.
- 날짜: 7월 29일 (1일차) & 7월 30일 (2일차)
- 시간: 매일 오전 9시 PST
- 장소: 온라인 – 어디서든 참여 가능!
개발자가 MCP를 개발 워크플로우에 활용할 수 있도록 지원하고, 뛰어난 MCP 커뮤니티를 축하하는 날입니다. Arcade, Block, Okta, Neon 등 커뮤니티 멤버 및 파트너들과 함께 Microsoft와 협력하여 개방적이고 확장 가능한 MCP 생태계를 만드는 과정을 살펴봅니다. VS Code, Visual Studio, GitHub Copilot, 인기 커뮤니티 도구를 활용한 실제 데모, 실용적이고 컨텍스트 기반의 개발 워크플로우, 커뮤니티 주도 세션과 인사이트가 포함됩니다. MCP를 처음 접하든 이미 사용 중이든, 1일차는 영감과 실질적인 팁을 제공합니다.
MCP 서버를 구축하고 AI 워크플로우에 MCP를 통합하는 구현 전략과 모범 사례를 깊이 있게 다룹니다.
- MCP 서버 구축 및 에이전트 경험에 통합하기
- 프롬프트 기반 개발
- 보안 모범 사례
- Functions, ACA, API Management 같은 빌딩 블록 활용
- 레지스트리 정렬 및 도구 (1P + 3P)
개발자, 도구 제작자, AI 제품 전략가라면 확장 가능하고 안전하며 미래 지향적인 MCP 솔루션 구축에 필요한 인사이트를 얻을 수 있는 날입니다.
| 모듈 | 주제 | 설명 | 링크 |
|---|---|---|---|
| 모듈 1-3: 기본 개념 | |||
| 00 | MCP 소개 | Model Context Protocol 개요 및 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 | SSE 서버 | Server-Sent Events를 이용한 서버 만들기 | 가이드 |
| 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 통합 | Azure와 MCP 통합 | 가이드 |
| 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를 이용한 인증 | Guide |
| 5.13 | Foundry 통합 | Azure AI Foundry와 통합하기 | Guide |
| 5.14 | 컨텍스트 엔지니어링 | 효과적인 컨텍스트 엔지니어링 기법 | Guide |
| 모듈 6-10: 커뮤니티 & 모범 사례 | |||
| 06 | 커뮤니티 기여 | MCP 생태계에 기여하는 방법 | Guide |
| 07 | 초기 도입 사례 인사이트 | 실제 구현 사례 이야기 | Guide |
| 08 | MCP 모범 사례 | 성능, 내결함성, 복원력 | Guide |
| 09 | MCP 사례 연구 | 실무 적용 사례 | Guide |
| 10 | 실습 워크숍 | AI 툴킷으로 MCP 서버 구축하기 | Lab |
| 언어 | 설명 | 링크 |
|---|---|---|
| C# | MCP 서버 예제 | View Code |
| Java | MCP 계산기 | View Code |
| JavaScript | MCP 데모 | View Code |
| Python | MCP 서버 | View Code |
| TypeScript | MCP 예제 | View Code |
| 언어 | 설명 | 링크 |
|---|---|---|
| C# | 고급 샘플 | View Code |
| Java | 컨테이너 앱 예제 | View Code |
| JavaScript | 고급 샘플 | View Code |
| Python | 복잡한 구현 | View Code |
| TypeScript | 컨테이너 샘플 | View Code |
이 커리큘럼을 최대한 활용하려면 다음을 갖추는 것이 좋습니다:
-
C#, Java, JavaScript, Python, TypeScript 중 최소 한 가지 언어에 대한 기본 프로그래밍 지식
-
클라이언트-서버 모델과 API에 대한 이해
-
REST 및 HTTP 개념에 대한 친숙함
-
(선택 사항) AI/ML 개념에 대한 배경 지식
-
지원을 위한 커뮤니티 토론 참여
이 저장소에는 효과적인 학습을 돕기 위한 다양한 자료가 포함되어 있습니다:
포괄적인 학습 가이드를 통해 이 저장소를 효율적으로 탐색할 수 있습니다. 가이드에는 다음이 포함됩니다:
- 다루는 모든 주제를 시각화한 커리큘럼 맵
- 각 저장소 섹션에 대한 상세 설명
- 샘플 프로젝트 활용 방법 안내
- 다양한 수준별 추천 학습 경로
- 학습 여정을 보완하는 추가 자료
커리큘럼 자료의 주요 업데이트를 기록한 상세한 변경 로그를 유지하고 있습니다. 내용에는 다음이 포함됩니다:
- 신규 콘텐츠 추가
- 구조 변경
- 기능 개선
- 문서 업데이트
각 강의에는 다음이 포함되어 있습니다:
- MCP 개념에 대한 명확한 설명
- 여러 언어로 된 실시간 코드 예제
- 실제 MCP 애플리케이션을 만드는 연습 문제
- 고급 학습자를 위한 추가 자료
중요한 코드 샘플을 기여해 주신 Microsoft Valued Professional Shivam Goyal 님께 감사드립니다.
이 콘텐츠는 MIT 라이선스 하에 제공됩니다. 이용 약관은 LICENSE에서 확인하세요.
이 프로젝트는 기여와 제안을 환영합니다. 대부분의 기여는 기여자가 해당 기여에 대한 권리를 보유하고 있으며 실제로 권리를 부여한다는 내용을 명시하는 Contributor License Agreement(CLA)에 동의해야 합니다. 자세한 내용은 https://cla.opensource.microsoft.com를 참고하세요.
풀 리퀘스트를 제출하면 CLA 봇이 자동으로 CLA 제출 필요 여부를 판단하고 PR에 적절한 표시(예: 상태 검사, 댓글)를 추가합니다. 봇의 안내에 따라 진행하면 되며, 이 과정은 모든 저장소에서 한 번만 수행하면 됩니다.
이 프로젝트는 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
- .NET을 이용한 생성 AI 입문
- JavaScript를 이용한 생성 AI 입문
- 생성 AI 입문
- ML 입문
- 데이터 과학 입문
- AI 입문
- 사이버보안 입문
- 웹 개발 입문
- IoT 입문
- XR 개발 입문
- AI 페어 프로그래밍을 위한 GitHub Copilot 마스터하기
- C#/.NET 개발자를 위한 GitHub Copilot 마스터하기
- 나만의 Copilot 모험 선택하기
이 프로젝트에는 프로젝트, 제품 또는 서비스의 상표나 로고가 포함될 수 있습니다. Microsoft 상표나 로고의 사용은 Microsoft 상표 및 브랜드 가이드라인을 준수해야 하며, 승인된 경우에만 가능합니다. 수정된 버전의 프로젝트에서 Microsoft 상표나 로고를 사용할 경우 혼동을 일으키거나 Microsoft의 후원을 암시해서는 안 됩니다. 제3자 상표나 로고 사용은 해당 제3자의 정책을 따라야 합니다.
면책 조항:
이 문서는 AI 번역 서비스 Co-op Translator를 사용하여 번역되었습니다. 정확성을 위해 최선을 다하고 있으나, 자동 번역에는 오류나 부정확한 부분이 있을 수 있음을 유의하시기 바랍니다. 원문은 해당 언어의 원본 문서가 권위 있는 출처로 간주되어야 합니다. 중요한 정보의 경우 전문적인 인간 번역을 권장합니다. 본 번역 사용으로 인해 발생하는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다.