MCP Servers Learning Project

MCP 服务学习项目

此代码库包含 Model Context Protocol（MCP）服务和客户端的示例与实现。MCP 是一种协议，可让 Claude 等大模型以标准化的方式与外部工具和数据源交互。

项目结构

代码库分为多个模块，分别聚焦于 MCP 的不同方面：

1. 快速入门资源

1_quickstart-resources 目录包含 MCP 客户端和服务的示例实现，帮助你快速上手：

• mcp-client-python：用于连接 MCP 服务的 Python 客户端实现
• mcp-client-typescript：用于连接 MCP 服务的 TypeScript 客户端实现
• weather-server-python：提供天气信息的 Python MCP 服务示例
• weather-server-typescript：提供天气信息的 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

连接到 Claude Desktop

要将 MCP 服务连接到 Claude Desktop：

mcp install <path_to_server.py>

核心概念

• 工具：Claude 可调用以执行代码或产生副作用的函数
• 资源：向 Claude 暴露、可供读取和引用的数据
• 提示词：用于组织与 Claude 交互的模板

贡献

欢迎根据自己的使用场景扩展和修改这些示例。如果你开发了实用的 MCP 服务，不妨与社区分享！

资源

• Model Context Protocol 文档
• MCP Python SDK
• Claude Desktop