MCP Client Example ☀️

MCP Client Example ☀️

site icon
2025.03.10 12
PythonMCP协议实现工具服务开发效率
MCP Client Example 是一个基于模型上下文协议(MCP)的简单客户端-服务器实现示例。该项目展示了如何创建自定义工具的MCP服务器,并通过MCP客户端连接和调用这些工具。主要功能包括BMI计算和天气数据获取。
View on GitHub

Overview

基本能力

产品定位

MCP Client Example 是一个演示项目,用于展示如何使用模型上下文协议(MCP)连接大型语言模型与工具和数据。

核心功能

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

适用场景

  • 开发人员学习和理解MCP协议
  • 快速搭建基于MCP的工具服务
  • 测试和调试MCP客户端和服务器的交互

工具列表

  1. calculate_bmi - 计算身体质量指数(BMI)的简单计算器
  2. fetch_weather - 从外部API获取天气数据的异步工具

常见问题解答

  • 项目使用了Model Context Protocol Python SDK和MCP官方文档作为资源
  • 项目采用MIT许可证

使用教程

使用依赖

  • Python 3.9+
  • uv (Python包管理器)

安装教程

# 安装依赖
uv install -e .

运行示例

  1. 启动客户端(将自动启动服务器):
uv run src/client/mcp_client.py

调试方式

使用MCP Inspector进行调试:

mcp dev src/server/example_server.py

然后访问 http://localhost:5173

许可证

该项目遵循 MIT 开源许可条款。