AgentQL MCP サーバー

これは、 AgentQLのデータ抽出機能を統合するモデル コンテキスト プロトコル (MCP) サーバーです。

特徴

ツール

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

Related MCP server: Fetcher MCP

インストール

AgentQL MCP サーバーを使用して Web ページからデータを抽出するには、npm 経由でインストールし、 Dev Portalから API キーを取得し、MCP をサポートするお気に入りのアプリで構成する必要があります。

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

npm install -g agentql-mcp

クロードを設定する

• ⌘ + ,で Claude デスクトップ設定を開きます (Claude アカウント設定と混同しないでください)

• 開発者サイドバーセクションに移動

• **「設定の編集」**をクリックし、 claude_desktop_config.jsonファイルを開きます。

• 設定ファイルのmcpServers辞書内にagentqlサーバーを追加します。

• アプリを再起動してください

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

Claude での MCP 構成の詳細については、ここを参照してください。

カーソルの設定

• カーソル設定を開く

• MCP > MCPサーバーへ移動

• + 新しいMCPサーバーを追加をクリックします

• 以下を入力してください:

  • 名前: 「agentql」（またはお好みの名前）

  • タイプ:「コマンド」

  • コマンド: env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

Cursor での MCP 構成の詳細については、ここを参照してください。

Windsurfの設定

• Open Windsurf: MCP 構成パネル

• カスタムサーバーの追加+をクリック

• あるいは、 ~/.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統合の検証

エージェントに、Webからデータを抽出するタスクを割り当てます。例:

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.

[!TIP] AgentQL を使用する代わりに、エージェントが URL を開いたり Web からコンテンツを読み込んだりできないというエラーを表示する場合は、「ツールを使用する」または「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"
      }
    }
  }
}

[!NOTE] Claude が 2 つの類似したサーバーを混同しないように、デフォルトの AgentQL MCP サーバー構成を忘れずに削除してください。

デバッグ

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

npm run inspector

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。