模型上下文协议工具

MCP(Model Context Protocol)是一个开放标准,定义了AI模型如何连接到外部工具、数据源和服务,提供通用接口以实现客户端与服务器的通信。

  • by Mahendra-Palagiri
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Mahendra-Palagiri/mcp

使用说明

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项目——将所有概念整合到一个真实的服务器中