Chuk MCP Echo Server

🚀 MCP エコーサーバー

MCP エコーサーバーは、Python ベースの軽量級マイクロサービスです。簡単なエコー機能を提供し、MCP フレームワーク内で基本的な診断とテストツールとして機能します。クライアントからのメッセージを受信し、そのまま返すことができます。

🚀 クイックスタート

MCP エコーサーバーを使い始めるには、まずインストールを行い、その後サーバーを起動します。以下に詳細な手順を示します。

✨ 主な機能

• メッセージエコー: サーバーに送信されたすべてのメッセージを返します。
• 全面的な検証: Pydantic モデルを使用して強力な入力検証を行います。
• 非同期サーバーアーキテクチャ: asyncio を使用して構築されており、高性能です。
• 柔軟な設定: 環境変数と設定ファイルを通じて設定が可能です。

📦 インストール

前提条件

• 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  # Windows の場合は `venv\Scripts\activate` を使用

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

pip install .  # 編集可能なモードでパッケージをインストール

開発用インストール

開発環境を設定するには:

pip install .[dev]  # 開発用の依存関係を含めてパッケージをインストール

💻 使用例

基本的な使用法

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

chuk-mcp-echo-server

プログラムでの使用

from chuk_mcp_echo_server.main import main

if __name__ == "__main__":
    main()

高度な使用法

エコーツールの使用

# エコーツールの使用例
echo("Hello, world!")

このコードでは、echo 関数に文字列を渡し、その文字列を返す EchoResult オブジェクトを取得します。

📚 ドキュメント

プロジェクト詳細

依存関係

核心依存関係

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

開発依存関係

• pytest (>=8.3.5)

環境変数

• NO_BOOTSTRAP: コンポーネントの起動ブートストラップを無効にするために設定します。
• その他の設定オプションは設定ファイルで設定できます。

🔧 技術詳細

このサーバーは、Python の asyncio ライブラリを使用して非同期的に動作するように構築されています。Pydantic を使用して入力検証を行い、環境変数と YAML 設定ファイルを通じて柔軟に設定できます。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。