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

一个 minimalist 的 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 文件。