MCPサーバーTESS

TESS API との統合のための MCP (Model Context Protocol) サーバー。

の上

このプロジェクトは、TESS API と対話するために MCP プロトコルに従うサーバーを実装します。サーバーは、次のことを可能にするツールを公開します。

• リストエージェントと管理エージェント

• カスタムメッセージでエージェントを実行する

• ファイルとエージェントとの関連付けの管理

• その他にも

Related MCP server: MCP Toolkit

要件

• 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á?"}
    ]
  }'

ライセンス

マサチューセッツ工科大学