MCP Client for Testing

テスト用 MCP クライアント

MCP サーバーのツール呼び出しをテストするための、最小限の MCP（Model Context Protocol）クライアントです。

使用方法

uv をインストールし、次のようにして MCP サーバーのツール呼び出しをテストします。

uvx mcp-client-for-testing \
    --config '
    [
        {
            "name": "name of mcp server",
            "command": "uv",
            "args": [
                "--directory", 
                "path/to/root/dir/", 
                "run", 
                "server.py"
            ],
            "env": {}
        }
    ]
    ' \
    --client_log_level "WARNING" \
    --server_log_level "INFO" \
    --tool_call '{"name": "tool-name", "arguments": {}}'

コード内で使用するには、パッケージをインストールします。

uv pip install mcp-client-for-testing 

そして、次のように使用します。

import asyncio

from mcp_client_for_testing.client import execute_tool

async def main():
    config = [
        {
            "name": "name of mcp server",
            "command": "uv",
            "args": [
                "--directory", 
                "path/to/root/dir/", 
                "run", 
                "server.py"
            ],
            "env": {}
        }
    ]
    tool_call = {"name": "tool-name", "arguments": {}}
    
    await execute_tool(config, tool_call)

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 [email protected]: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 を使用してパッケージをビルドします。

uv build

新しいバージョンのリリース

パッケージの新しいバージョンを PyPI にリリースするには、新しい Git タグを作成してプッシュします。

1. main ブランチをチェックアウトし、現在のバージョンを確認します。

   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 ファイルをご覧ください。