MCP Echo Server

MCP Echo Server

概要

MCP Echo Server は、シンプルなエコー機能を提供する、軽量な Python ベースのマイクロサービスです。メッセージを受信してクライアントにそのまま返すため、MCP フレームワーク内で基本的な診断やテストを行うツールとして利用できます。

プロジェクトの詳細

• バージョン：0.1.0
• Python の互換性：Python 3.11 以降

機能

• メッセージのエコー：サーバーに送信されたメッセージをそのまま返します
• 包括的な検証：Pydantic モデルを使用して堅牢な入力検証を行います
• 非同期サーバーアーキテクチャ：asyncio を使用し、効率的なパフォーマンスを実現します
• 柔軟な設定：環境変数と設定ファイルを使って設定できます

依存関係

コア依存関係：

• mcp (>=1.6.0)
• pydantic (>=2.11.2)
• PyYAML (>=6.0.2)

開発用依存関係：

• pytest (>=8.3.5)

インストール

前提条件

• Python 3.11 以降
• pip
• （任意）仮想環境の使用を推奨します

PyPI からインストール

pip install chuk-mcp-echo-server

ソースからインストール

1. リポジトリをクローンします：

git clone <repository-url>
cd chuk-mcp-echo-server

2. 仮想環境を作成します：

python -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. パッケージをインストールします：

pip install .  # Installs the package in editable mode

開発用インストール

開発環境をセットアップするには：

pip install .[dev]  # Installs package with development dependencies

サーバーの実行

コマンドラインインターフェース

chuk-mcp-echo-server

プログラムからの使用

from chuk_mcp_echo_server.main import main

if __name__ == "__main__":
    main()

環境変数

• NO_BOOTSTRAP：コンポーネントのブートストラップを無効にする場合に設定します
• その他の設定オプションは、設定ファイルで指定できます

利用可能なツール

Echo

入力：

• message：エコーとして返す文字列メッセージ

例：

echo("Hello, world!")

戻り値：

• EchoResult オブジェクト内の元のメッセージ

開発

コードのフォーマット

• コードのフォーマットには Black を使用します
• インポートの並べ替えには isort を使用します
• 1 行の長さは 88 文字に設定されています

テストの実行

pytest

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/AmazingFeature）
3. コードがフォーマットとテストに合格することを確認します
4. 変更をコミットします（git commit -m 'Add some AmazingFeature'）
5. ブランチにプッシュします（git push origin feature/AmazingFeature）
6. プルリクエストを作成します

ライセンス

MIT ライセンス