AgentQL MCP Server

AgentQL MCP サーバー

これは、AgentQL のデータ抽出機能を統合する Model Context Protocol（MCP）サーバーです。

機能

ツール

• extract-web-data - 指定した「url」から、抽出する実際のデータとそのフィールドの説明として「prompt」を使用し、構造化データを抽出します。

インストール

AgentQL MCP サーバーを使用してウェブページからデータを抽出するには、npm 経由でインストールし、開発者ポータルから API キーを取得して、MCP に対応したお好みのアプリで設定する必要があります。

パッケージをインストールする

npm install -g agentql-mcp

Claude を設定する

• ⌘+, を押して Claude Desktop の設定を開きます（Claude アカウント設定と間違えないでください）。
• 開発者サイドバーのセクションに移動します。
• 設定を編集をクリックし、claude_desktop_config.json ファイルを開きます。
• 設定ファイルの mcpServers 辞書内に agentql サーバーを追加します。
• アプリを再起動します。

{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude での MCP 設定について詳しくは、こちらをご覧ください。

VS Code を設定する

ワンクリックでインストールするには、以下のインストールボタンのいずれかをクリックしてください。

手動インストール

最も簡単にインストールするには、このセクションの上部にあるインストールボタンをクリックしてください。手動でインストールする場合は、次の手順に従ってください。

以下の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加します。Ctrl + Shift + P を押して Preferences: Open User Settings (JSON) と入力すると追加できます。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "AgentQL API Key",
        "password": true
      }
    ],
    "servers": {
      "agentql": {
        "command": "npx",
        "args": ["-y", "agentql-mcp"],
        "env": {
          "AGENTQL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

必要に応じて、ワークスペース内の .vscode/mcp.json というファイルに追加することもできます。これにより、設定を他のユーザーと共有できます。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "AgentQL API Key",
      "password": true
    }
  ],
  "servers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

Cursor を設定する

• Cursor の設定を開きます。
• MCP > MCP Serversに移動します。
• + Add new MCP Serverをクリックします。
• 以下を入力します。
  • 名前：「agentql」（または任意の名前）
  • 種類：「command」
  • コマンド：env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

Cursor での MCP 設定について詳しくは、こちらをご覧ください。

Windsurf を設定する

• Windsurf: MCP Configuration Panelを開きます。
• **Add custom server+**をクリックします。
• または、~/.codeium/windsurf/mcp_config.json を直接開きます。
• 設定ファイルの mcpServers 辞書内に agentql サーバーを追加します。

{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf での MCP 設定について詳しくは、こちらをご覧ください。

MCP 統合を検証する

ウェブからのデータ抽出が必要なタスクをエージェントに依頼します。例：

Extract the list of videos from the page https://www.youtube.com/results?search_query=agentql, every video should have a title, an author name, a number of views and a url to the video. Make sure to exclude ads items. Format this as a markdown table.

ヒント

AgentQL を使用せずに URL を開いたり、ウェブからコンテンツを読み込んだりできないとエージェントが訴える場合は、「ツールを使用」または「AgentQL ツールを使用」というヒントを追加してみてください。

開発

依存関係をインストールします：

npm install

サーバーをビルドします：

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

開発版を試したい場合は、デフォルトの設定の代わりに以下の設定を使用できます：

{
  "mcpServers": {
    "agentql": {
      "command": "/path/to/agentql-mcp/dist/index.js",
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

メモ

Claude が類似した2つのサーバーで混乱しないよう、デフォルトの AgentQL MCP サーバー設定を忘れずに削除してください。

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします：

npm run inspector

Inspector から、ブラウザーでデバッグツールにアクセスするための URL が提供されます。