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 文件。