echo-mcp-server-for-testing

echo-mcp-server-for-testing

MCP クライアントのテストに使える、シンプルな echo_tool を備えたシンプルなエコー MCP（Model Context Protocol）サーバーです。 新しい MCP サーバーのテンプレートとしても最適です。

使用方法

uv をインストールし、uvx を使って MCP 設定にサーバーを追加します。

{
    "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!"}}'

フォーマットとリンティング

コードのフォーマットとリンティングには 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 ファイルをご覧ください。