MCP (模型上下文协议) 教程

<div align="center">

</div>

📚 学习阶段

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