microsoft/mcp-for-beginners

이 리소스들을 사용하여 시작하려면 다음 단계들을 따르세요:

저장소 포크 (Fork the Repository): **저장소 복제 (Clone the Repository)**를 클릭하세요: git clone https://github.com/microsoft/mcp-for-beginners.git

참여하기 (Join The)

로컬에 복제(Clone)하는 것을 선호하시나요? 이 저장소에는 50개 이상의 언어 번역이 포함되어 있어 다운로드 크기가 상당히 커집니다. 번역을 제외하고 복제하려면 희소 체크아웃 (sparse checkout)을 사용하세요:

Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'

CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"

이렇게 하면 훨씬 빠른 다운로드 속도로 과정을 완료하는 데 필요한 모든 것을 얻을 수 있습니다.

Model Context Protocol (MCP)로의 여정에 오신 것을 환영합니다! AI 애플리케이션이 어떻게 다양한 도구 및 서비스와 통신하는지 궁금한 적이 있었다면, 개발자들이 지능형 시스템을 구축하는 방식을 변화시키고 있는 우아한 솔루션을 곧 발견하게 될 것입니다.

MCP를 AI 애플리케이션을 위한 범용 번역기라고 생각해보세요. USB 포트가 어떤 장치든 컴퓨터에 연결할 수 있게 해주는 것처럼, MCP는 AI 모델이 표준화된 방식으로 모든 도구(tool)나 서비스에 연결할 수 있도록 해줍니다. 여러분이 첫 번째 챗봇(chatbot)을 만들고 있든, 복잡한 AI 워크플로우(workflows)를 작업하고 있든, MCP를 이해하면 더 유능하고 유연한 애플리케이션을 만들 수 있는 힘을 얻게 될 것입니다.

이 커리큘럼은 여러분의 학습 여정을 위해 인내심과 정성을 담아 설계되었습니다. 이미 알고 있는 간단한 개념부터 시작하여, 여러분이 선호하는 프로그래밍 언어로 직접 실습하며 점진적으로 전문성을 쌓아갈 것입니다. 모든 단계에는 명확한 설명과 실용적인 예시, 그리고 과정 내내 충분한 격려가 포함되어 있습니다.

이 여정을 마칠 때쯤이면, 여러분은 자신만의 MCP 서버(servers)를 구축하고, 이를 인기 있는 AI 플랫폼과 통합하며, 이 기술이 AI 개발의 미래를 어떻게 재편하고 있는지 이해할 수 있는 자신감을 갖게 될 것입니다. 이 흥미로운 모험을 함께 시작해 봅시다!

이 커리큘럼은 MCP Specification 2025-11-25(최신 안정 버전)를 기준으로 합니다. MCP 사양(specification)은 명확한 프로토콜 버전 추적을 보장하기 위해 날짜 기반 버전 관리(YYYY-MM-DD 형식)를 사용합니다.

이 리소스들은 여러분의 이해도가 높아질수록 더욱 가치 있게 느껴지겠지만, 모든 내용을 즉시 읽어야 한다는 압박감을 느낄 필요는 없습니다. 가장 관심 있는 분야부터 시작하세요!

📘 MCP Documentation (MCP 문서) – 단계별 튜토리얼과 사용자 가이드를 확인할 수 있는 필수 리소스입니다. 문서는 초보자를 염두에 두고 작성되었으며, 자신의 속도에 맞춰 따라 할 수 있는 명확한 예시를 제공합니다.
📜 MCP Specification (MCP 명세서) – 종합적인 참조 매뉴얼이라고 생각하면 됩니다. 커리큘럼을 진행하면서 특정 세부 사항을 찾아보거나 고급 기능을 탐색하기 위해 이곳을 다시 찾게 될 것입니다.
📜 MCP Specification Versioning (MCP 명세서 버전 관리) – 프로토콜 버전 이력과 MCP가 날짜 기반 버전 관리(YYYY-MM-DD 형식)를 사용하는 방법에 대한 정보가 포함되어 있습니다.
🧑💻 MCP GitHub Repository (MCP GitHub 저장소) – 다양한 프로그래밍 언어로 된 SDK, 도구 및 코드 샘플을 찾을 수 있습니다. 실용적인 예시와 즉시 사용 가능한 구성 요소들이 가득한 보물창고와 같습니다.
🌐 MCP Community (MCP 커뮤니티) – MCP에 관한 토론을 통해 동료 학습자 및 숙련된 개발자들과 함께하세요. 질문이 환영받고 지식이 자유롭게 공유되는 지원적인 커뮤니티입니다.

이 커리큘럼을 마칠 때쯤이면, 여러분은 새로운 능력에 대해 자신감과 설렘을 느끼게 될 것입니다. 여러분이 달성하게 될 목표는 다음과 같습니다:

• MCP 기초 이해: 비유와 예시를 통해 Model Context Protocol (MCP)이 무엇인지, 그리고 왜 이것이 AI 애플리케이션들이 함께 작동하는 방식을 혁신하고 있는지 파악하게 됩니다.

• 첫 번째 MCP 서버 구축: 선호하는 프로그래밍 언어로 작동하는 MCP 서버를 만들게 되며, 간단한 예시부터 시작하여 단계별로 기술을 키워나갑니다.

• AI 모델을 실제 도구에 연결: AI 모델과 실제 서비스 사이의 간극을 메우는 방법을 배워, 여러분의 애플리케이션에 강력하고 새로운 기능을 부여하게 됩니다.

• 보안 모범 사례 구현: MCP 구현을 안전하게 유지하는 방법을 이해하여, 애플리케이션과 사용자 모두를 보호할 수 있습니다.

• 자신감 있는 배포: 실제 환경에서 작동하는 실용적인 배포 전략을 통해, MCP 프로젝트를 개발 단계에서 운영 단계로 전환하는 방법을 알게 됩니다.

• MCP 커뮤니티 참여 (Join the MCP community): 여러분은 AI 애플리케이션 개발의 미래를 형성해 나가는 성장하는 개발자 커뮤니티의 일원이 될 것입니다.

MCP의 세부 사항을 깊이 파고들기 전에, 몇 가지 기초적인 개념들을 편안하게 받아들일 수 있도록 준비해 보겠습니다. 이 분야의 전문가가 아니더라도 걱정하지 마세요. 진행하면서 알아야 할 모든 내용을 설명해 드릴 것입니다!

프로토콜 (Protocol)을 대화를 위한 규칙이라고 생각해 보세요. 친구에게 전화를 걸면, 두 사람 모두 전화를 받았을 때 "안녕"이라고 말하고, 차례대로 말하며, 대화가 끝나면 "잘 가"라고 말해야 한다는 것을 알고 있습니다. 컴퓨터 프로그램도 효과적으로 통신하기 위해서는 이와 유사한 규칙이 필요합니다.

MCP는 프로토콜입니다. 즉, AI 모델과 애플리케이션이 도구(Tools) 및 서비스와 생산적인 "대화"를 나눌 수 있도록 돕는 합의된 규칙의 집합입니다. 대화 규칙이 있으면 사람 간의 의사소통이 더 원활해지는 것처럼, MCP를 사용하면 AI 애플리케이션의 통신이 훨씬 더 신뢰할 수 있고 강력해집니다.

여러분은 이미 매일 클라이언트-서버 (Client-server) 관계를 사용하고 있습니다! 웹 브라우저 (클라이언트)를 사용하여 웹사이트를 방문할 때, 여러분은 페이지 콘텐츠를 보내주는 웹 서버에 연결하고 있는 것입니다. 브라우저는 정보를 요청하는 방법을 알고 있고, 서버는 응답하는 방법을 알고 있습니다.

MCP에서도 이와 유사한 관계가 존재합니다. AI 모델은 정보나 동작을 요청하는 클라이언트 (Client) 역할을 하고, MCP 서버 (Server)는 그러한 기능들을 제공합니다. 이는 AI가 특정 작업을 수행하도록 요청할 수 있는 유능한 비서 (서버)를 두는 것과 같습니다.

만약 모든 자동차 제조사가 서로 다른 모양의 주유기를 사용한다고 상상해 보세요. 차마다 각기 다른 어댑터가 필요할 것입니다! 표준화 (Standardization)란 사물들이 원활하게 함께 작동할 수 있도록 공통된 접근 방식에 합의하는 것을 의미합니다.

MCP는 AI 애플리케이션을 위한 이러한 표준화를 제공합니다. 모든 AI 모델이 모든 도구와 작동하기 위해 맞춤형 코드 (Custom code)를 작성할 필요 없이, MCP는 이들이 통신할 수 있는 보편적인 방법을 만들어 줍니다. 이는 개발자가 도구를 한 번만 구축하면 이를 다양한 AI 시스템에서 사용할 수 있음을 의미합니다.

여러분의 MCP 여정은 자신감과 기술을 점진적으로 쌓을 수 있도록 세심하게 구성되어 있습니다. 각 단계는 이미 배운 내용을 강화하는 동시에 새로운 개념을 소개합니다.

여기서 여러분의 모험이 시작됩니다! 친숙한 비유와 간단한 예시를 사용하여 MCP 개념을 소개해 드릴 것입니다. 여러분은 MCP가 무엇인지, 왜 존재하는지, 그리고 AI 개발이라는 더 큰 세계에서 어떻게 자리 잡고 있는지 이해하게 될 것입니다.

• Module 0 - MCP 소개 (Introduction to MCP): MCP가 무엇인지, 그리고 현대 AI 애플리케이션에서 왜 그토록 중요한지 탐구하며 시작합니다. MCP가 실제로 작동하는 실세계 사례를 살펴보고, 개발자들이 직면하는 일반적인 문제들을 MCP가 어떻게 해결하는지 이해하게 됩니다.

• Module 1 - 핵심 개념 설명 (Core Concepts Explained): 여기에서는 MCP의 필수적인 구성 요소들을 배웁니다. 이러한 개념들이 자연스럽고 이해하기 쉽도록 풍부한 비유와 시각적 예시를 사용할 것입니다.

• Module 2 - MCP의 보안 (Security in MCP): 보안이라는 말이 위협적으로 들릴 수도 있지만, MCP에 내장된 안전 기능들을 보여주고 시작부터 애플리케이션을 보호할 수 있는 모범 사례 (Best Practices)를 가르쳐 드릴 것입니다.

이제 진짜 재미있는 단계가 시작됩니다! 실제 MCP 서버와 클라이언트를 구축하며 직접 실습해 보는 경험을 하게 될 것입니다. 걱정하지 마세요. 간단한 것부터 시작하여 모든 단계를 안내해 드릴 것입니다.

이 모듈에는 여러분이 선호하는 프로그래밍 언어로 연습할 수 있는 여러 실습 가이드가 포함되어 있습니다. 첫 번째 서버를 만들고, 이에 연결할 클라이언트를 구축하며, VS Code와 같은 인기 있는 개발 도구와 통합하는 과정까지 경험하게 됩니다.

각 가이드에는 완전한 코드 예제, 문제 해결 (Troubleshooting) 팁, 그리고 특정 설계 선택을 내린 이유에 대한 설명이 포함되어 있습니다. 이 단계가 끝날 때쯤이면 여러분은 자랑스러워할 만한 작동 가능한 MCP 구현물을 갖게 될 것입니다!

기초를 마스터하면, 더 정교한 MCP 기능들을 탐구할 준비가 된 것입니다. 실질적인 구현 전략, 디버깅 (Debugging) 기술, 그리고 멀티모달 (Multi-modal) AI 통합과 같은 고급 주제들을 다룰 것입니다.

또한 MCP 구현을 프로덕션 (Production) 환경에서 사용할 수 있도록 확장하는 방법과 Azure와 같은 클라우드 플랫폼 (Cloud platforms)과 통합하는 방법도 배우게 됩니다. 이 모듈들은 실제 환경의 요구 사항을 처리할 수 있는 MCP 솔루션을 구축할 수 있도록 준비시켜 줍니다.

마지막 단계는 MCP 커뮤니티에 참여하고 가장 관심 있는 분야를 전문화하는 데 중점을 둡니다. 오픈 소스 (Open-source) MCP 프로젝트에 기여하는 방법, 고급 인증 패턴 (Authentication patterns)을 구현하는 방법, 그리고 포괄적인 데이터베이스 통합 솔루션을 구축하는 방법을 배우게 됩니다.

모듈 11은 특별히 언급할 가치가 있습니다. 이는 PostgreSQL 통합을 통해 프로덕션 준비가 된 MCP 서버를 구축하는 방법을 가르치는 13개의 실습 (Lab)으로 구성된 완전한 핸즈온 (Hands-on) 학습 경로입니다. 이는 여러분이 배운 모든 것을 하나로 모으는 캡스톤 프로젝트 (Capstone project)와 같습니다!

모듈	주제	설명	링크
모듈 0-3: 기초 (Fundamentals)
00	MCP 소개	모델 컨텍스트 프로토콜 (Model Context Protocol)의 개요 및 AI 파이프라인 (Pipelines)에서의 중요성	더 읽어보기
01	핵심 개념 설명	핵심 MCP 개념에 대한 심층 탐구	더 읽어보기
...	모듈 3: 첫 번째 서버 및 클라이언트 구축
3.1	첫 번째 서버	첫 번째 MCP 서버 생성	가이드
3.2	첫 번째 클라이언트	기본적인 MCP 클라이언트 개발	가이드
...	모듈 4-5: 실무 및 고급
04	실무 구현	SDK, 디버깅 (Debugging), 테스트 (Testing), 재사용 가능한 프롬프트 템플릿 (Prompt templates)	더 읽어보기
4.1	페이지네이션 (Pagination)	커서 기반 페이지네이션 (Cursor-based pagination)을 통한 대규모 결과 세트 처리	가이드
...	모듈 6-10: 커뮤니티 및 베스트 프랙티스 (Best Practices)
06	커뮤니티 기여	MCP 생태계에 기여하는 방법	가이드
07	초기 도입 사례의 통찰	실제 구현 사례 연구	가이드
...	모듈 11: MCP 서버 핸즈온 랩 (Hands On Lab)
11	MCP 서버 데이터베이스 통합	PostgreSQL 통합을 위한 13개 실습 구성의 포괄적인 핸즈온 학습 경로	실습
11.1	소개	데이터베이스 통합 및 리테일 분석 (Retail analytics) 유스케이스 (Use case)를 포함한 MCP 개요	실습 00
...

|
MCP를 배우는 가장 흥미로운 부분 중 하나는 여러분의 코딩 기술이 점진적으로 발전하는 것을 보는 것입니다. 우리는 여러분의 이해도가 깊어짐에 따라 단순한 단계에서 시작하여 점점 더 정교해지도록 코드 예제를 설계했습니다. 개념을 소개하는 방식은 다음과 같습니다. 이해하기 쉬우면서도 실제 MCP 원칙을 보여주는 코드를 통해, 여러분은 이 코드가 무엇을 하는지뿐만 아니라 왜 이런 구조로 되어 있는지, 그리고 더 큰 MCP 애플리케이션에 어떻게 부합하는지를 이해하게 될 것입니다.

언어 (Language)	설명 (Description)	링크 (Link)
C#	MCP 서버 예제 (MCP Server Example)	코드 보기 (View Code)
...
언어 (Language)	설명 (Description)	링크 (Link)
---	---	---
C#	고급 샘플 (Advanced Sample)	코드 보기 (View Code)
...
이 커리큘럼을 최대한 활용하려면 다음 사항을 갖추어야 합니다:

다음 언어 중 적어도 하나에 대한 기본적인 프로그래밍 지식: C#, Java, JavaScript, Python 또는 TypeScript

클라이언트-서버 모델 (Client-server model) 및 API에 대한 이해

REST 및 HTTP 개념에 대한 익숙함

(선택 사항) AI/ML 개념에 대한 배경 지식

지원을 위해 우리의 커뮤니티 토론에 참여하기

이 리포지토리(Repository)에는 여러분이 효과적으로 탐색하고 학습할 수 있도록 돕는 여러 리소스가 포함되어 있습니다:

이 리포지토리를 효과적으로 탐색할 수 있도록 돕는 포괄적인 학습 가이드 (Study Guide)가 준비되어 있습니다. 이 시각적 커리큘럼 지도 (Curriculum map)는 모든 주제가 어떻게 연결되는지 보여주며, 샘플 프로젝트를 효과적으로 사용하는 방법에 대한 지침을 제공합니다. 이는 전체적인 그림을 보는 것을 좋아하는 시각적 학습자에게 특히 유용합니다.

가이드에는 다음 내용이 포함됩니다:

다루는 모든 주제를 보여주는 시각적 커리큘럼 지도 (Curriculum map)
각 리포지토리 섹션에 대한 상세한 분석
샘플 프로젝트 사용 방법에 대한 지침
다양한 숙련도에 따른 권장 학습 경로
학습 여정을 보완할 추가 리소스

microsoft/mcp-for-beginners

요약

핵심 포인트

댓글