AgentQL

AgentQL MCP Сервер

Это сервер Model Context Protocol (MCP), который интегрирует возможности извлечения данных AgentQL.

Возможности

Инструменты

• extract-web-data — извлечение структурированных данных с указанного 'url', используя 'prompt' как описание фактических данных и их полей для извлечения.

Установка

Чтобы использовать AgentQL MCP Server для извлечения данных с веб-страниц, вам необходимо установить его через npm, получить API-ключ в нашем Dev Portal и настроить его в вашем любимом приложении, поддерживающем MCP.

Установка пакета

npm install -g agentql-mcp

Настройка Claude

• Откройте Настройки Claude Desktop через ⌘+, (не путайте с настройками аккаунта Claude)
• Перейдите в боковую секцию Developer
• Нажмите Edit Config и откройте файл claude_desktop_config.json
• Добавьте сервер agentql в словарь mcpServers в файле конфигурации
• Перезапустите приложение

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

Подробнее о настройке MCP в Claude читайте здесь.

Настройка VS Code

Для установки в один клик нажмите одну из кнопок установки ниже:

Ручная установка

Нажмите кнопки установки в начале этого раздела для самого быстрого способа установки. Для ручной установки выполните следующие шаги:

Добавьте следующий блок JSON в файл пользовательских настроек (JSON) в VS Code. Это можно сделать, нажав 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 Settings
• Перейдите в MCP > MCP Servers
• Нажмите + Add new MCP Server
• Введите следующее:
  • Name: "agentql" (или любое другое имя)
  • Type: "command"
  • Command: env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

Подробнее о настройке MCP в Cursor читайте здесь.

Настройка Windsurf

• Откройте Windsurf: MCP Configuration Panel
• Нажмите Add custom server+
• Либо вы можете открыть ~/.codeium/windsurf/mcp_config.json напрямую
• Добавьте сервер agentql в словарь mcpServers в файле конфигурации

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

Подробнее о настройке MCP в Windsurf читайте здесь.

Проверка интеграции 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.

[!TIP] Если ваш агент жалуется, что не может открыть URL-адреса или загрузить контент из интернета вместо использования AgentQL, попробуйте добавить подсказку «используй инструменты» или «используй инструмент 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] Не забудьте удалить стандартную конфигурацию AgentQL MCP сервера, чтобы не сбивать Claude с толку двумя похожими серверами.

Отладка

Поскольку MCP-серверы общаются через stdio, отладка может быть затруднительной. Мы рекомендуем использовать MCP Inspector, который доступен в виде скрипта пакета:

npm run inspector

Инспектор предоставит URL-адрес для доступа к инструментам отладки в вашем браузере.