MCPClient Python Application

MCPClient Python Application

site icon
2025.04.14 0
Python开发效率开发效率
MCPClient 是一个 Python 客户端应用程序,旨在与 MCP(Model Context Protocol)服务器进行交互。它提供了异步通信、自定义服务器脚本、工具管理、聊天界面等功能,适用于需要与 MCP 服务器进行交互的开发场景。
View on GitHub

Overview

基本能力

产品定位

MCPClient 是一个用于与 MCP 服务器交互的 Python 客户端工具,主要用于开发效率和工具集成场景。

核心功能

  • 异步通信:使用 asyncio 实现非阻塞通信。
  • 自定义服务器脚本:支持连接 Python 和 JavaScript 服务器脚本。
  • 工具管理:动态获取并与服务器上的工具交互。
  • 聊天界面:提供简单的命令行界面与服务器进行对话。
  • 工具集成:支持从服务器响应中提取 JSON 格式的工具调用并执行。
  • 环境变量加载:使用 dotenv 包从 .env 文件加载环境变量。

适用场景

  • 开发环境中与 MCP 服务器的交互。
  • 需要动态调用服务器工具的场景。
  • 需要异步通信和工具集成的开发任务。

工具列表

  • asyncio:用于异步通信。
  • requests:用于 HTTP 请求。
  • mcp:自定义库,用于处理 MCP 通信。
  • dotenv:用于环境变量管理。

常见问题解答

  • 如何连接服务器? 通过提供的脚本路径(.py.js)连接。
  • 如何执行工具调用? 从服务器响应中提取 JSON 格式的工具调用并执行。
  • 如何加载环境变量? 在根目录创建 .env 文件并设置变量。

使用教程

使用依赖

  • Python 3.7 或更高版本。
  • 安装依赖库: bash pip install -r requirements.txt

安装教程

  1. 克隆仓库或下载脚本文件到本地。
  2. 安装依赖库: bash pip install -r requirements.txt
  3. 创建 .env 文件并设置环境变量,例如: BASE_URL=http://localhost:11434 MODEL=llama3.2
  4. 运行客户端: bash python client.py <server_script_path>

调试方式

  1. 确保服务器脚本路径正确。
  2. 检查 .env 文件中的环境变量是否设置正确。
  3. 运行客户端并观察命令行输出,确保与服务器的交互正常。
  4. 如果遇到工具调用问题,检查服务器响应中的 JSON 格式是否正确。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。