MCP (Model Context Protocol) Tutorial

학습 단계

Step 0: MCP 이해하기

• MCP 개념 및 구조
  • Resources, Tools, Prompts 이해
  • MCP Server, Host, Client에 대한 이해
  • MCP vs 전통적인 API
  • 통신 프로토콜 이해

Step 1: MCP Inspector 활용

• Inspector를 통한 테스트
  • 기본 서버 구현 (examples/country_server/country_server.py)
  • Inspector 사용법
  • 세션 관리 및 통신 방식

Step 2: 외부 서비스 연동

• Google Calendar 연동 (진행 예정)
• Slack 연동 (진행 예정)
• Figma 연동 (진행 예정)

시작하기

• 외부 라이브러리는 fastmcp, mcp-agent를 사용한다.

환경 설정

# Poetry 설치 (필요한 경우)
curl -sSL https://install.python-poetry.org | python3 -

# 프로젝트 의존성 설치
poetry install

# 가상환경 활성화
poetry shell

기본 서버 실행

mcp dev examples/country_server/country_server.py

프로젝트 구조 (초안)

.
├── docs/
│ ├── 00_MCP란?.md
│ └── 01_MCP inspector를 활용한 테스트.md
├── examples/country_server/country_server.py # 기본 MCP 서버 예제
├── country_client.py # Python 클라이언트 예제
├── pyproject.toml # 의존성 관리
└── README.md

참고 자료

공식 문서

• MCP 공식 문서
• FastMPC 예제
• MCP Agent 예제
• Python SDK GitHub

커뮤니티 자료

• 간단하게 만들면서 이해해보는 MCP
• Awesome MCP Servers
• PyTorch KR Discussion
• https://www.dailydoseofds.com/p/visual-guide-to-model-context-protocol-mcp/

추가 학습 자료

• Building Effective Agents - Anthropic