MCP Client For Testing

🚀 テスト用最小化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 ファイルを参照してください。