Echo MCP Server For Testing

🚀 テスト用エコーMCPサーバー

このプロジェクトは、簡単なエコーMCP（モデルコンテキストプロトコル）サーバーです。MCPクライアントのテストに使用できる echo_tool も付属しています。また、新しいMCPサーバーのテンプレートとしても利用できます。

🚀 クイックスタート

🔧 使用方法

uv をインストールし、サーバーをMCP設定に追加して uvx を使用する方法：

{
    "name": "echo-mcp-server-for-testing",
    "command": "uvx",
    "args": [
        "echo-mcp-server-for-testing"
    ],
    "env": {
        "SECRET_KEY": "123456789"
    }
}

または、リポジトリをクローンして uv を使用してディレクトリを指定する方法：

{
    "name": "echo-mcp-server-for-testing",
    "command": "uv",
    "args": [
        "--directory", 
        "path/to/root/dir/", 
        "run", 
        "main.py"
    ],
    "env": {
        "SECRET_KEY": "123456789"
    }
}

🔧 技術詳細

🧪 テスト

リポジトリをクローンし、mcp-client-for-testing を使用してサーバーをテストする方法：

uvx mcp-client-for-testing \
    --config '
    [
        {
            "name": "echo-mcp-server-for-testing",
            "command": "uv",
            "args": [
                "--directory", 
                "path/to/root/dir/", 
                "run", 
                "main.py"
            ],
            "env": {
                "SECRET_KEY": "123456789"
            }
        }
    ]
    ' \
    --tool_call '{"name": "echo_tool", "arguments": {"message": "Hello, world!"}}'

🎨 フォーマットとLinting

ruff を使用してコードのフォーマットとチェックを行う方法：

uv run ruff format
uv run ruff check --fix

📦 ビルドとuv

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 ファイルを参照してください。