MCP Client For Testing

🚀 用于测试的最小化 MCP 客户端

这是一个简约的 MCP（Model Context Protocol）客户端，主要用于测试 MCP 服务器中的工具调用，能有效验证服务器工具调用功能的准确性和稳定性。

🚀 快速开始

测试工具调用

首先，你需要安装 uv，然后在 MCP 服务器中进行工具调用测试：

uvx mcp-client-for-testing \
    --config '
    [
        {
            "name": "mcp 服务端的名称",
            "command": "uv",
            "args": [
                "--directory", 
                "根目录路径/", 
                "run", 
                "server.py"
            ],
            "env": {}
        }
    ]
    ' \
    --client_log_level "WARNING" \
    --server_log_level "INFO" \
    --tool_call '{"name": "工具名称", "arguments": {}}'

代码中使用

若要在代码中使用该客户端，需先安装包：

uv pip install mcp-client-for-testing 

接着按以下方式使用：

import asyncio
import logging
import json
from mcp_client_for_testing.client import execute_tool

async def main():
    config = [
        {
            "name": "mcp 服务端的名称",
            "command": "uv",
            "args": [
                "--directory", 
                "根目录路径/", 
                "run", 
                "server.py"
            ],
            "env": {}
        }
    ]
    tool_call = {"name": "工具名称", "arguments": {}}
    
    await execute_tool(config, tool_call, server_log_level_int=logging.DEBUG)

if __name__ == "__main__":
    asyncio.run(main())

💻 使用示例

基础用法

使用 echo-mcp-server-for-testing 与 uvx 测试 MCP 客户端：

uvx mcp-client-for-testing \
    --config '
    [
        {
            "name": "echo-mcp-server-for-testing",
            "command": "uvx",
            "args": [
                "echo-mcp-server-for-testing"
            ],
            "env": {
                "SECRET_KEY": "123456789"
            }
        }
    ]
    ' \
    --client_log_level "WARNING" \
    --server_log_level "INFO" \
    --tool_call '{"name": "echo_tool", "arguments": {"message": "Hello, world!"}}'

📦 安装指南

从源码安装

1. 克隆仓库：git clone git@github.com:piebro/mcp-client-for-testing.git。
2. 进入根目录：cd mcp-client-for-testing。
3. 以开发模式安装：uv pip install -e .

格式化和检查代码

使用 ruff 格式化和检查代码：

uv run ruff format
uv run ruff check --fix

使用 uv 构建

构建包：

uv build

发布新版本

要将新版本发布到 PyPI，请按以下步骤创建并推送新的 Git 标签：

1. 切换到主要分支并获取当前版本：

   git checkout main
   git pull origin main
   git describe --tags
   

2. 创建并推送新的 Git 标签：

   git tag v0.2.0
   git push origin v0.2.0
   

GitHub Actions 工作流会在推送新的标签时自动构建并发布包到 PyPI。Python 包的版本号将直接从 Git 标签中派生。

📄 许可证

本项目在 MIT 许可证下分发。有关详细信息，请参阅 LICENSE 文件。