AI导哈

模型上下文协议客户端示例

一个使用模型上下文协议（MCP）实现客户端-服务器交互的示例项目，展示了如何创建MCP服务器、连接客户端以及调用工具获取响应。

  • by RGGH
  • Python
  • 本地部署
  • 26 星标
  • 更新于
在 GitHub 查看 RGGH/mcp-client-x

使用说明

MCP客户端示例☀️

这个项目演示了一个使用模型上下文协议（MCP）的简单客户端-服务器实现，MCP是一种将大型语言模型与工具和数据连接起来的标准化方法。

概述

此示例显示了如何：

  • 使用自定义工具创建MCP服务器
  • 使用MCP客户端连接到服务器
  • 调用工具并从服务器获取响应

教程视频

单击上图观看MCP实现教程。

项目结构

.
├── pyproject.toml
├── README.md
├── src
│   ├── client
│   │   └── mcp_client.py      # MCP client implementation
│   └── server
│       └── example_server.py  # MCP server with tools
└── uv.lock

服务器实现

服务器公开了两个工具：

  1. calculate_bmi -一个计算体重指数的简单计算器
  2. fetch_weather -从外部API检索天气数据的异步工具

客户端实施

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

入门指南

先决条件

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

安装

# Install dependencies
uv install -e .

运行示例

  1. 启动客户端（这将自动启动服务器）：
uv run src/client/mcp_client.py

用法

客户将：

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

示例响应

Available tools: meta=None nextCursor=None tools=[...]
BMI calculation result: 22.857142857142858
Weather data: {"current_weather":{"temperature":14.2,"windspeed":12.6, ...}}

使用MCP检查员进行测试

（运行下面的命令，然后访问http://localhost:5173 )

  ❯ mcp dev src/server/example_server.py
Starting MCP inspector...
Proxy server listening on port 3000

🔍 MCP Inspector is up and running at http://localhost:5173 🚀
New SSE connection
Query parameters: {
  transportType: 'stdio',
  command: 'uv',
  args: 'run --with mcp mcp run src/server/example_server.py',

资源

本项目使用：

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP