MCP服务器学习项目
此存储库包含模型上下文协议(MCP)服务器和客户端的示例和实现。MCP是一种协议,允许像Claude这样的LLM以标准化的方式与外部工具和数据源进行交互。
项目结构
存储库分为几个模块,每个模块都侧重于MCP的不同方面:
1.快速入门资源
这 1_quickstart-resources 目录包含MCP客户端和服务器的示例实现,以帮助您入门:
- mcp客户端python:用于连接到MCP服务器的Python客户端实现
- mcp客户端打字脚本:用于连接到MCP服务器的TypeScript客户端实现
- 天气服务器python:提供天气信息的Python MCP服务器示例
- 气象服务器打字稿:一个提供天气信息的TypeScript MCP服务器示例
这些示例演示了基本的MCP概念,并为您自己的实现提供了起点。
2.MCP文档服务器
这 2_mcpdoc 目录包含一个用于提供文档的专用MCP服务器:
- 实现一个可以从各种来源检索和提供文档的MCP服务器
- 包括配置示例和稳健的项目结构
- 演示高级MCP概念,如错误处理和资源管理
3.终端服务器
这 3_building_securing_and_containerizing_mcp_server 目录包含一个自定义MCP服务器实现,该实现:
- 显示终端命令执行工具,允许访问系统命令
- 提供访问MCP文档的资源
- 演示正确的错误处理和输入验证
- 演示如何在单个服务器中实现工具和资源
入门指南
先决条件
- Python 3.10或更高版本
- MCP SDK 1.2.0或更高版本
- 对于TypeScript示例:Node.js和npm
安装
# For Python dependencies
uv add "mcp[cli]" httpx
# Or with pip
pip install "mcp[cli]" httpx正在运行MCP服务器
您可以使用以下命令运行任何MCP服务器:
# With Python directly
python
# Or with the MCP CLI
mcp dev
例如,要运行终端服务器:
python 3_building_securing_and_containerizing_mcp_server/server.py
# Or
mcp dev 3_building_securing_and_containerizing_mcp_server/server.py连接到克劳德桌面
要将MCP服务器连接到Claude Desktop,请执行以下操作:
mcp install
关键概念
- 工具:Claude可以调用以执行代码或产生副作用的函数
- 资源:可供Claude读取和引用的数据
- 鼓励:用于构建与Claude交互的模板
贡献
您可以根据自己的用例自由扩展和修改这些示例。如果你开发了一个有用的MCP服务器,可以考虑与社区共享!
