Selector MCP Server

🚀 Selector AI FastMCP 選択器AI高速コンテキストプロトコル

このリポジトリは、Selector AIのModel Context Protocol（MCP）の完全な実装を提供します。リアルタイムストリーミングをサポートするサーバーと、stdin/stdoutを介して通信するDockerベースのインタラクティブなクライアントが含まれています。

✨ 主な機能

✅ サーバー

• FastMCP互換で、Pythonで構築されています。
• リアルタイムSSEストリーミングをサポートします。
• Selector AIとのインタラクティブなAIチャットが可能です。
• ボイラープレートコードを最小限に抑えます。
• コンテナオーケストレーションに適した組み込みヘルスチェックがあります。
• リクエスト/レスポンスのログ記録とリトライ機能があります。

✅ クライアント

• PythonクライアントはDockerを介してサーバーを起動します。
• CLIとプログラムによるアクセスをサポートします。
• stdinとstdoutを介した読み書きが可能です。
• .envファイルを使用して環境変数を設定できます。

🚀 クイックスタート

前提条件

• Python 3.8以上
• Docker
• Selector AI APIキー
• Selector API URL

インストール

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

   git clone https://github.com/automateyournetwork/selector-mcp-server
   cd selector-ai-mcp
   

2. Pythonの依存関係をインストールします：

   pip install -r requirements.txt
   

3. 環境変数を設定します。.envファイルを作成します：

   SELECTOR_URL=https://your-selector-api-url
   SELECTOR_AI_API_KEY=your-api-key
   

🐳 Dockerfile

サーバーは軽量コンテナで実行され、以下のDockerfileを使用します：

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["python", "-u", "mcp_server.py"]
HEALTHCHECK --interval=30s --timeout=30s --start-period=5s \
  CMD python -c "import socket; s = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM); s.connect('/tmp/mcp.sock'); s.send(b'{\"tool_name\": \"ready\"}\\n'); data = s.recv(1024); s.close(); import json; result = json.loads(data); exit(0 if result.get('status') == 'ready' else 1)" || exit 1

🧠 クライアントの使用

クライアントを起動します：

python mcp_client.py

サンプルCLIセッション

You> What is AIOps?
Selector> AIOps指的是将AI应用于IT运维...

プログラムによるアクセス

from selector_client import call_tool, spawn_server

proc = spawn_server()
call_tool(proc, "ready")
response = call_tool(proc, "ask_selector", {"content": "What is AIOps?"})
print(response)

🖥️ Claude Desktopとの統合

サーバーを起動します：

python mcp_server.py

Claude Desktopでローカルエンドポイントを構成します。メッセージ形式が以下のようになっていることを確認してください：

{
  "method": "tools/call",
  "tool_name": "ask_selector",
  "content": "What can you tell me about device S6?"
}

🛠️ カスタムビルド

1. このリポジトリをフォークまたはクローンします。
2. selector_fastmcp_server.pyを変更して、お好みのモデルまたはルーティングロジックを統合します。
3. Dockerイメージを再構築します：

   docker build -t your-image-name .
   

4. クライアント設定を構成します。例えば、.envファイルでAPIキーとURLを指定します。

📁 プロジェクト構造

• selector_fastmcp_server.py: メインサーバーロジック
• selector_client.py: クライアント機能の実装
• requirements.txt: Pythonの依存関係リスト
• .env.example: 環境変数のサンプル

✅ 要件

• Python 3.8以上がインストールされている必要があります。
• コンテナ化デプロイにはDockerが必要です。

📄 ライセンス

このプロジェクトはApache 2.0ライセンスを使用しています。