Echo MCP Server

🚀 声 MCP サーバー

Model Context Protocol (MCP) をベースにしたシンプルなエコーサーバーの実装です。このサーバーは MCP インターフェースを通じて基本的なエコー機能を提供します。

🚀 クイックスタート

エコー MCP サーバーは .NET Core を使用して構築され、Model Context Protocol C# SDK（github.com/modelcontextprotocol/csharp-sdk）を採用しています。これは、メッセージをそのままクライアントに返すツールを提供します。このサーバーは軽量に設計されており、MCP を使用して簡単な機能を持つカスタムサーバーを作成する方法を示しています。ローカルマシンまたは Docker コンテナにデプロイすることができます。

✨ 主な機能

• クライアントに任意のメッセージをエコーする
• 設定によりカスタマイズ可能なメッセージ形式
• Model Context Protocol 標準に基づいて構築

📦 インストール

前提条件

• .NET 9.0（ローカル開発/デプロイ用）
• Docker（コンテナデプロイ用）

開発ビルドの手順

ソースコードからプロジェクトをビルドする場合は、以下の手順に従ってください。

1. このリポジトリをクローンします。

   git clone https://github.com/yourusername/echo-mcp-server.git
   

2. プロジェクトのルートディレクトリに移動します。

   cd echo-mcp-server
   

3. 以下のコマンドを使用してプロジェクトをビルドします。

   dotnet build src/echo.sln
   

4. テストを実行します。

   dotnet test src/echo.sln
   

Docker サポート

Docker イメージの手動構築

自分で Docker イメージを構築するには、以下のコマンドを実行します。

# リポジトリのルートディレクトリに移動
cd echo-mcp-server

# Docker イメージを構築
docker build -f src/Core.Infrastructure.McpServer/Dockerfile -t echo-mcp-server:latest src/

# ローカルで構築したイメージを実行
docker run -d --name echo-mcp echo-mcp-server:latest

📚 ドキュメント

MCP プロトコルの使用

クライアントの設定

クライアントでエコーサーバーを設定するには、次の内容を appsettings.json ファイルに追加してください。

{
  "McpEchoOptions": {
    "Address": "tcp://localhost:5001"
  }
}

設定

環境変数

以下の環境変数を設定することで、エコーサーバーの動作を構成することができます。

• ECHO_MESSAGE: 表示するカスタムメッセージ。
• ECHO_COLOR: メッセージの色（ANSI 色コードをサポート）。

例えば、コンソールに赤色で “Hello, World!” を表示するには、次のコマンドを実行します。

docker run -e ECHO_MESSAGE="Hello, World!" -e ECHO_COLOR=31 echo-mcp-server:latest

ファイル設定

カスタムの appsettings.json ファイルを作成することで、サーバーを構成することもできます。例えば：

{
  "McpEchoOptions": {
    "Message": "你好，世界！",
    "Color": "32"
  }
}

その後、コンテナを実行する際にこのファイルをマウントします。

docker run -v /path/to/custom-settings.json:/app/appsettings.json echo-mcp-server:latest

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされており、詳細は LICENSE ファイルを参照してください。