Brightsy MCP

🚀 Brightsy MCP サーバー

これは Brightsy AI エージェントに接続するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用することで、AI エージェントとの通信を効率的に行うことができます。

🚀 クイックスタート

📦 インストール

以下のコマンドを実行して依存関係をインストールします。

npm install

💻 使用例

基本的な使用法

サーバーを起動するには、以下のコマンドを実行します。

npm start -- --agent-id=<your-agent-id> --api-key=<your-api-key>

または、位置引数を使用することもできます。

npm start -- <your-agent-id> <your-api-key> [tool-name] [message]

エージェントに初期メッセージを送信する場合は、以下のように実行します。

npm start -- --agent-id=<your-agent-id> --api-key=<your-api-key> --message="Hello, agent!"

高度な使用法

カスタムツール名の指定

デフォルトでは、MCP サーバーは "brightsy" という名前のツールを登録します。--tool-name パラメータを使用して名前をカスタマイズすることができます。

npm start -- --agent-id=<your-agent-id> --api-key=<your-api-key> --tool-name=<custom-tool-name>

または、ツール名を第3の位置引数として指定することもできます。

npm start -- <your-agent-id> <your-api-key> <custom-tool-name>

環境変数 BRIGHTSY_TOOL_NAME を使用することもできます。

export BRIGHTSY_TOOL_NAME=custom-tool-name
npm start -- --agent-id=<your-agent-id> --api-key=<your-api-key>

環境変数の使用

以下の環境変数を使用してサーバーを構成することができます。

🔧 agent_proxy ツールのテスト

前提条件

テストを実行する前に、以下の環境変数を設定する必要があります。

export AGENT_ID=your-agent-id
export API_KEY=your-api-key
# オプション：テスト用のカスタムツール名
export TOOL_NAME=custom-tool-name

または、コマンドライン引数を使用してこれらの値を渡すこともできます。

# 名前付き引数を使用
npm run test:cli -- --agent-id=your-agent-id --api-key=your-api-key --tool-name=custom-tool-name

# 位置引数を使用
npm run test:cli -- your-agent-id your-api-key custom-tool-name

テストの実行

すべてのテストを実行するには、以下のコマンドを実行します。

npm test

特定のテストを実行するには、以下のコマンドを使用します。

# コマンドラインインターフェースのテスト
npm run test:cli

# 直接 MCP プロトコルのテスト
npm run test:direct

テストスクリプト

1. コマンドラインテスト (test-agent-proxy.ts)：MCP サーバーを起動し、テストメッセージを送信することで agent_proxy ツールをテストします。
2. 直接 MCP プロトコルテスト (test-direct.ts)：サーバーに形式が正しい MCP リクエストを直接送信することで agent_proxy ツールをテストします。

📚 ツールの仕組み

MCP サーバーは、ツール（デフォルト名は "brightsy"）を登録し、このツールはリクエストを OpenAI 互換の AI エージェントに転送し、応答を返します。messages パラメータを受け取り、これは role と content 属性を持つメッセージオブジェクトの配列です。

以下は、MCP クライアントでの使用例です。

// デフォルトのツール名を使用
const response = await client.callTool("brightsy", {
  messages: [
    {
      role: "user",
      content: "Hello, can you help me with a simple task?"
    }
  ]
});

// または、カスタマイズしたツール名を使用（設定されている場合）
const response = await client.callTool("custom-tool-name", {
  messages: [
    {
      role: "user",
      content: "Hello, can you help me with a simple task?"
    }
  ]
});

応答には、エージェントの返信が content フィールドに含まれます。