Agent.ai MCP Server

Agent.ai MCP サーバー

Agent.ai API と連携する MCP サーバーの実装です。動的な関数読み込みシステムを通じて、ウェブテキストの抽出、ウェブページのスクリーンショット、YouTube の文字起こし機能を提供します。

機能

• 動的な関数読み込み：Agent.ai API から利用可能な関数を自動的に取得します
• ウェブテキストの抽出：ウェブページからテキストコンテンツをスクレイピングまたはクロールします
• ウェブページのスクリーンショット：ウェブページの画像をキャプチャします
• YouTube の文字起こし：YouTube 動画から文字起こしを抽出します
• キャッシュ：関数定義を効率的にキャッシュし、API 呼び出しを削減します

ツール

このサーバーは Agent.ai API からツールを動的に読み込みます。現在利用可能なツールは次のとおりです。

• grab_web_text

  • ウェブページからテキストコンテンツを抽出します
  • 入力：
    • url（文字列、必須）：抽出対象のウェブページの URL
    • mode（文字列、任意）：1 ページを対象とする "scrape"、最大 100 ページを対象とする "crawl"

• grab_web_screenshot

  • ウェブページの画像をキャプチャします
  • 入力：
    • url（文字列、必須）：キャプチャ対象のウェブページの URL
    • ttl_for_screenshot（整数、任意）：秒単位のキャッシュ有効期間

• get_youtube_transcript

  • YouTube 動画の文字起こしを取得します
  • 入力：
    • url（文字列、必須）：YouTube 動画の URL

ほかにも数十種類のツールがあります。利用可能なすべてのツールについては、https://docs.agent.ai/api-reference をご覧ください。

設定

API トークンの取得

この MCP サーバーを使用するには、Agent.ai API トークンが必要です。トークンを取得するには Agent.ai にお問い合わせください。

Claude Desktop での使用

次の内容を claude_desktop_config.json に追加してください。

Docker

{
  "mcpServers": {
    "agentai": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "API_TOKEN",
        "mcp/agentai"
      ],
      "env": {
        "API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "agentai": {
      "command": "npx",
      "args": [
        "-y",
        "@agentai/mcp-server"
      ],
      "env": {
        "API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

API の使用例

ウェブテキストの抽出

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"url":"https://agent.ai","mode":"scrape"}'
};

fetch('https://api-lr.agent.ai/v1/action/grab_web_text', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

ウェブページのスクリーンショットのキャプチャ

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"url":"https://agent.ai","ttl_for_screenshot":86400}'
};

fetch('https://api-lr.agent.ai/v1/action/grab_web_screenshot', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

YouTube の文字起こしの取得

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"url":"https://youtube.com/watch?v=example"}'
};

fetch('https://api-lr.agent.ai/v1/action/get_youtube_transcript', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

ビルド

Docker のビルド：

docker build -t mcp/agentai:latest .

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。