🚀 MCP 客户端示例 ☀️

本项目为您展示了如何运用模型上下文协议（MCP）实现简单的客户端 - 服务器架构。MCP 作为一种标准方式，能将大型语言模型与工具和数据进行有效连接，为您的开发工作提供便利。

🚀 快速开始

先决条件

• Python 3.9+
• uv（Python 包管理器）

安装

# 安装依赖项
uv install -e .

运行示例

1. 启动客户端（会自动启动服务器）：

uv run src/client/mcp_client.py

✨ 主要特性

• 演示了带有自定义工具的 MCP 服务器的创建过程。
• 展示了通过 MCP 客户端连接到服务器的方法。
• 可调用服务器工具并获取响应。

📦 安装指南

依赖安装

# 安装依赖项
uv install -e .

运行示例

启动客户端（会自动启动服务器）：

uv run src/client/mcp_client.py

💻 使用示例

基础用法

客户端将执行以下操作：

1. 连接到服务器
2. 列出可用工具
3. 调用 BMI 计算器的示例数据
4. 调用天气工具并提供示例坐标

示例响应

可用工具：meta=None nextCursor=None tools=[...]
BMI 计算结果：22.857142857142858
天气数据：{"current_weather":{"temperature":14.2,"windspeed":12.6, ...}}

📚 详细文档

教程视频

点击下面的图片观看关于 MCP 实现的教程：

项目结构

.
├── pyproject.toml
├── README.md
├── src
│   ├── client
│   │   └── mcp_client.py      # MCP 客户端实现
│   └── server
│       └── example_server.py  # 带有工具的MCP服务器
└── uv.lock

服务器实现

该服务器公开了两个工具：

1. calculate_bmi - 一个简单的计算器，用于计算身体质量指数（BMI）
2. fetch_weather - 一个异步工具，从外部 API 获取天气数据

客户端实现

客户端通过标准输入输出连接到服务器，初始化会话，并调用服务器的工具。

使用 MCP Inspector 测试

（运行以下命令后访问 http://localhost:5173）

  ❯ mcp dev src/server/example_server.py
启动 MCP 检查工具...
代理服务器在端口 3000 监听

🔍 MCP 检查工具已启动并运行于 http://localhost:5173 🚀
新 SSE 连接
查询参数：{
  transportType: 'stdio',
  command: 'uv',
  args: 'run --with mcp mcp run src/server/example_server.py',

资源

该项目使用：

• 模型上下文协议 Python SDK
• MCP 官方文档

📄 许可证

该项目采用 MIT License - 详细信息请查看 LICENSE 文件