MCP CLI Client

MCP CLI Client

site icon
2025.03.05 0
Python命令行工具JSON-RPCPython 模块开发效率
MCP CLI Client 是一个命令行界面工具,用于通过本地连接(STDIO)或远程连接(SSE)与 MCP(Machine Communication Protocol)服务器进行交互。它支持发送 JSON-RPC 请求,并可以在命令行模式和交互模式下工作,同时也可以作为 Python 模块集成到其他项目中。
View on GitHub

Overview

基本能力

产品定位

MCP CLI Client 是一个用于与 MCP 服务器交互的命令行工具,支持本地和远程连接,适用于开发者和系统管理员。

核心功能

  • 通过 STDIO 连接本地 MCP 服务器
  • 通过 SSE 连接远程 MCP 服务器
  • 发送 JSON-RPC 请求
  • 支持命令行模式和交互模式
  • 可作为 Python 模块集成到其他项目中

适用场景

  • 开发调试 MCP 服务器
  • 自动化脚本与 MCP 服务器交互
  • 集成 MCP 功能到其他 Python 项目中

工具列表

  • MCPClient:Python 模块,提供与 MCP 服务器交互的功能
  • 命令行工具:支持直接发送请求或进入交互模式

常见问题解答

  • 如何配置远程服务器 URL? 在 .env 文件中设置 MCP_SERVER_URL
  • 如何调试连接问题? 检查 .env 配置并确保服务器运行,使用 LOG_LEVEL=DEBUG 查看详细日志。

使用教程

使用依赖

  1. 确保已安装 Python 3.x
  2. 安装 Git(用于克隆仓库)

安装教程

  1. 克隆仓库: bash git clone https://github.com/Fbeunder/MCP_CLI_CLIENT.git cd MCP_CLI_CLIENT
  2. 创建虚拟环境(可选但推荐): bash python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate
  3. 安装依赖: bash pip install -r requirements.txt
  4. 配置应用: bash cp .env.example .env # 编辑 .env 文件配置
  5. 安装为 Python 包: bash pip install -e .

调试方式

  1. 运行测试: bash pytest
  2. 查看覆盖率报告: bash pytest --cov=src
  3. 调试连接问题: bash python main.py --local --method getVersion

许可证

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