Servidor MCP de AgentQL

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que integra las capacidades de extracción de datos de AgentQL .

Características

Herramientas

• extract-web-data : extrae datos estructurados de una 'URL' determinada, utilizando 'prompt' como descripción de los datos reales y sus campos a extraer.

Related MCP server: Fetcher MCP

Instalación

Para utilizar AgentQL MCP Server para extraer datos de páginas web, debe instalarlo a través de npm, obtener una clave API de nuestro Portal de desarrolladores y configurarlo en su aplicación favorita que admita MCP.

Instalar el paquete

npm install -g agentql-mcp

Configurar Claude

• Abra la configuración de escritorio de Claude mediante ⌘ + , (no confunda con la configuración de la cuenta de Claude)

• Vaya a la sección de la barra lateral del desarrollador

• Haga clic en Editar configuración y abra el archivo claude_desktop_config.json

• Agregue el servidor agentql dentro del diccionario mcpServers en el archivo de configuración

• Reiniciar la aplicación

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

Lea más sobre la configuración de MCP en Claude aquí .

Configurar cursor

• Abrir configuración del cursor

• Vaya a MCP > Servidores MCP

• Haga clic en + Agregar nuevo servidor MCP

• Introduzca lo siguiente:

  • Nombre: "agentql" (o su nombre preferido)

  • Tipo: "comando"

  • Comando: env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

Lea más sobre la configuración de MCP en Cursor aquí .

Configurar Windsurf

• Open Windsurf: Panel de configuración MCP

• Haga clic en Agregar servidor personalizado+

• Alternativamente, puede abrir ~/.codeium/windsurf/mcp_config.json directamente

• Agregue el servidor agentql dentro del diccionario mcpServers en el archivo de configuración

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

Lea más sobre la configuración de MCP en Windsurf aquí .

Validar la integración de MCP

Asigna a tu agente una tarea que requiera extraer datos de la web. Por ejemplo:

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] En caso de que su agente se queje de que no puede abrir URL o cargar contenido de la web en lugar de usar AgentQL, intente agregar la sugerencia "usar herramientas" o "usar herramienta agentql".

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Si desea probar la versión de desarrollo, puede utilizar la siguiente configuración en lugar de la predeterminada:

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

[!NOTA] No olvides eliminar la configuración del servidor MCP de AgentQL predeterminada para no confundir a Claude con dos servidores similares.

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.