使用说明
MCP学习杂志
从头开始学习模型上下文协议(MCP)的实践指南。
What is MCP?
MCP(模型上下文协议)是Anthropic的一个开放标准,它定义了人工智能模型如何连接到外部工具、数据源和服务——一个通用接口,因此任何客户端都可以与任何服务器通信。
服务器可以公开三个原语:
| 原始 | 受控 | 描述 |
|---|---|---|
| 工具 | 模型 | AI可以调用的函数 |
| 资源 | 应用程序/用户 | AI可以读取的数据 |
| 提示 | 用户 | 可重复使用的提示模板 |
Setup
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Running a Server
# Run directly
.venv/bin/python3 01_MCP_Primitives/01.server.py
# Run with MCP Inspector (recommended for testing)
npx @modelcontextprotocol/inspector .venv/bin/python3 01_MCP_Primitives/01.server.py
Tools Used
- Python MCP SDK —
mcp包装(FastMCP) - MCP检查员 —
npx @modelcontextprotocol/inspector--用于本地测试服务器的浏览器UI
Roadmap
完成
| 日 | 阶段 | 主题 | 文件 | 备注 |
|---|---|---|---|---|
| 01 | 01_MCP_Primitives | Hello World--最小服务器,一个工具,字符串参数 | 01.服务器.py | 笔记 |
| 02 | 01_MCP_Primitives | 多种工具+参数--int、bool、可选参数 | 02.tools.py | 笔记 |
| 03 | 01_MCP_优势 | MCP资源——静态和动态资源 @mcp.resource() |
03.资源.py | 笔记 |
| 04 | 01_MCP_优先级 | MCP提示——单圈和多圈提示 @mcp.prompt() |
04.提示.py | 笔记 |
即将到来的
| 日 | 阶段 | 主题 |
|---|---|---|
| 05 | 02_Real_World_Usage | Real-World工具-连接到外部API(例如天气、GitHub) |
| 06 | 02_全球_使用情况 | 运输模式-- stdio 与SSE/HTTP相比 |
| 07 | 02_Real_World_Usage | 克劳德桌面集成--将服务器连接到Claude.app配置中 |
| 08 | 03_生产_准备 | 背景、记录和进度——MCP Context 对象 |
| 09 | 03_生产_准备就绪 | 错误处理-- McpError,优雅的失败 |
| 10 | 04_Capstone | Capstone项目——将所有概念整合到一个真实的服务器中 |
