使用说明
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 <path_to_server.py>
# Or with the MCP CLI
mcp dev <path_to_server.py>
例如，要运行终端服务器：
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 <path_to_server.py>
关键概念
- 工具：Claude可以调用以执行代码或产生副作用的函数
- 资源：可供Claude读取和引用的数据
- 鼓励：用于构建与Claude交互的模板
贡献
您可以根据自己的用例自由扩展和修改这些示例。如果你开发了一个有用的MCP服务器，可以考虑与社区共享！
