Servidor TESS com Suporte a MCP

MCP 対応 TESS サーバー

これは、TESS（Text Evaluation and Semantic Services）と MCP（Multi-Channel Platform）を統合するプロキシサーバーです。

要件

• Node.js 18+
• Rust と Cargo
• wasm32-wasi ターゲット（rustup target add wasm32-wasi）

設定

1. リポジトリをクローンします
2. 依存関係をインストールします：

   npm install
   

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

   PORT=3000
   MCP_API_KEY=seu_mcp_api_key
   MCP_API_URL=https://www.mcp.run/api
   MCP_SSE_URL=https://www.mcp.run/api/sse
   

ビルド

WebAssembly プラグインをコンパイルするには：

npm run build

実行

サーバーを起動するには：

npm start

ホットリロードを使用した開発の場合：

npm run dev

エンドポイント

ヘルスチェック

• GET /health
• サーバーが稼働しているか確認します

MCP ツールの一覧表示

• GET /api/mcp/tools
• クエリパラメーター：
  • session_id：MCP セッションの ID
  • mcp_sse_url：MCP の SSE URL

MCP ツールの実行

• POST /api/mcp/execute
• クエリパラメーター：
  • session_id：MCP セッションの ID
  • mcp_sse_url：MCP の SSE URL
• ボディ：

  {
    "tool": "nome_da_ferramenta",
    "params": {
      // parâmetros específicos da ferramenta
    }
  }
  

アーキテクチャ

サーバーは次の要素で構成されています：

1. Node.js + Express：リクエストを受け取る HTTP サーバー
2. Rust/WebAssembly プラグイン：リクエストを処理する主要なロジック
3. MCP プロキシ：リクエストを MCP.run に転送します

開発

プラグインのコードは Rust で記述され、WebAssembly にコンパイルされます。Node.js サーバーはこのプラグインを読み込み、リクエストの処理に使用します。

サーバーの動作を変更するには：

1. src/lib.rs の Rust コードを編集します
2. npm run build でプラグインを再コンパイルします
3. サーバーを再起動します

ログとモニタリング

サーバーは次のログを記録します：

• サーバーの起動
• 処理エラー
• API 呼び出し

セキュリティ

• すべてのリクエストに有効な session_id を含める必要があります
• MCP の認証情報は環境変数で設定します
• 開発用に CORS が有効になっています

トラブルシューティング

問題が発生した場合：

1. プラグインが正しくコンパイルされていることを確認します
2. 環境変数が設定されていることを確認します
3. サーバーのログを確認します
4. MCP.run にアクセスできることを確認します