MCP-Server-TESS

MCP-Server-TESS

TESS API と連携するための MCP（Model Context Protocol）サーバーです。

概要

このプロジェクトでは、TESS API と連携するための MCP プロトコルに準拠したサーバーを実装しています。サーバーは、以下の操作を可能にするツールを公開します。

• エージェントの一覧表示と管理
• カスタムメッセージを使ったエージェントの実行
• ファイルとエージェントとの関連付けの管理
• その他多数

要件

• Node.js 18+
• TESS プラットフォームの API キー

インストール

Smithery.ai 経由（推奨）

このサーバーは Smithery.ai から直接利用できます。

1. https://smithery.ai/server/@diegofornalha/mcp-server-tess にアクセスします
2. 「インストール」をクリックします
3. 求められたら TESS API キーを設定します
4. これで完了です。お好みの LLM でサーバーを利用できます

ローカルインストール

リポジトリをクローンして、依存関係をインストールします。

git clone https://github.com/seu-usuario/mcp-server-tess.git
cd mcp-server-tess
npm install

設定

1. .env.example を基に .env ファイルを作成します
2. TESS の API キーを追加します。

TESS_API_KEY=sua_chave_api_aqui
PORT=3000

ビルド

npm run build

実行

本番モードでサーバーを起動するには、次を実行します。

npm start

自動リロードを有効にして開発するには、次を実行します。

npm run dev

利用可能なツール

サーバーは HTTP API 経由で以下のツールを公開します。

1. listar_agentes_tess - 利用可能なすべてのエージェントを一覧表示します
2. obter_agente_tess - 指定したエージェントの詳細を取得します
3. executar_agente_tess - カスタムメッセージを使ってエージェントを実行します
4. listar_arquivos_agente_tess - エージェントに関連付けられたファイルを一覧表示します
5. vincular_arquivo_agente_tess - ファイルをエージェントに関連付けます
6. remover_arquivo_agente_tess - ファイルとエージェントとの関連付けを解除します
7. listar_arquivos_tess - 利用可能なすべてのファイルを一覧表示します
8. obter_arquivo_tess - 指定したファイルの詳細を取得します
9. enviar_arquivo_tess - TESS プラットフォームに新しいファイルを送信します
10. excluir_arquivo_tess - TESS プラットフォームからファイルを削除します

Docker での使用

Docker を使ってサーバーを実行するには、次を実行します。

# Construir a imagem
docker build -t mcp-server-tess .

# Executar o container
docker run -p 3000:3000 -e TESS_API_KEY=sua_chave_api_aqui mcp-server-tess

API エンドポイント

• GET /health - サーバーの正常性を確認するエンドポイント
• GET /capabilities - 利用可能なすべてのツールと、その説明およびパラメーターを一覧表示します
• POST /tools/:toolName - 指定したツールを実行します（:toolName をツール名に置き換えてください）

使用例

Smithery.ai を使用する場合

Smithery.ai にインストールすると、MCP に対応した任意の LLM でサーバーを使用できます。

1. LLM の設定でサーバー @diegofornalha/mcp-server-tess を選択します
2. TESS API のツールがモデルで自動的に利用可能になります

HTTP API 経由

エージェントを実行するには、次のようにします。

curl -X POST http://localhost:3000/tools/executar_agente_tess \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "seu_agent_id",
    "model": "tess-ai-light",
    "messages": [
      {"role": "user", "content": "Olá, como você está?"}
    ]
  }'

ライセンス

MIT