Home
Login
apify/actors-mcp-server

Implementación del servidor del Protocolo de Contexto del Modelo (MCP) de Apify Actors, que permite a las aplicaciones de IA utilizar cualquier Apify Actor como herramienta para realizar tareas como la extracción de datos, la búsqueda web, etc.

Apache-2.0TypeScript 231apify Last Updated: 2025-06-13
https://github.com/apify/actors-mcp-server

Introducción Detallada al Servidor MCP de Apify Actors

Resumen del Proyecto

El servidor MCP de Apify Actors es una implementación de servidor basada en el Protocolo de Contexto del Modelo (Model Context Protocol, MCP), diseñado específicamente para proporcionar un acceso unificado a todos los Actors en la plataforma Apify. Este proyecto permite que las aplicaciones de IA y los agentes de IA interactúen con las herramientas de extracción de datos de Apify a través de un protocolo estandarizado.

Dirección del Proyecto: https://github.com/apify/actors-mcp-server Uso Principal: Integrar más de 200 herramientas de extracción de datos de la Apify Store como herramientas de IA en varias aplicaciones de IA. Plataformas Compatibles: Claude Desktop, Visual Studio Code, LibreChat y otros clientes MCP.

Características y Funcionalidades Clave

🔧 Modo de Despliegue Dual

  • Actor Servidor MCP: Se ejecuta como un servidor HTTP en la plataforma Apify, proporcionando acceso a través de eventos enviados por el servidor (Server-Sent Events, SSE).
  • Servidor Stdio Local: Se ejecuta en la máquina local, comunicándose con el cliente a través de la entrada/salida estándar (stdio).

🛠️ Integración de Herramientas Rica

El proyecto viene preconfigurado por defecto con las siguientes herramientas Actor principales:

  • Raspador de Instagram (apify/instagram-scraper): Extrae publicaciones, perfiles, ubicaciones, fotos y comentarios de Instagram.
  • Navegador Web RAG (apify/rag-web-browser): Búsqueda web, rastreo del contenido de la página y devuelve datos estructurados.
  • Extractor de Información de Contacto de Google Maps (lukaskrivka/google-maps-with-contact-details): Extrae información de contacto de negocios en Google Maps.

🔍 Descubrimiento Inteligente de Herramientas

  • get-actor-details: Recupera la documentación, el esquema de entrada y los detalles de un Actor específico.
  • discover-actors: Busca Actors relevantes utilizando palabras clave y devuelve información detallada.
  • Gestión Dinámica de Herramientas: Soporta la adición y eliminación de herramientas Actor en tiempo de ejecución (requiere soporte del cliente).

🎯 Soporte Multi-Cliente

Soporta los siguientes clientes MCP:

  • Claude Desktop: A través del protocolo de transmisión Stdio.
  • Visual Studio Code: Soporta transmisión Stdio y SSE.
  • LibreChat: Soporta transmisión Stdio y SSE.
  • Cliente de Prueba de Apify: Soporte completo de SSE y encabezados de autorización.
  • Otros clientes MCP estándar.

Arquitectura Técnica

Soporte de Protocolo

  • MCP (Model Context Protocol): Protocolo abierto que permite una interacción segura y controlada entre aplicaciones de IA y herramientas externas.
  • Métodos de Transmisión:
    • Server-Sent Events (SSE) - Para servidores HTTP remotos.
    • Standard Input/Output (Stdio) - Para comunicación de procesos locales.

Optimización del Procesamiento de Entrada

  • Truncamiento de la Descripción: Limita a 500 caracteres para mejorar la compatibilidad.
  • Optimización de Campos de Enumeración: Combina límites de longitud dentro de 200 caracteres.
  • Marcado de Campos Obligatorios: Identifica claramente los parámetros obligatorios.
  • Construcción de Atributos Anidados: Maneja configuraciones complejas como la configuración del proxy.
  • Inferencia de Tipo: Infiere automáticamente el tipo de elementos de la matriz.

Ejemplos de Casos de Uso

Análisis de Investigación de Datos

"Buscar en la web y resumir las últimas tendencias en agentes de IA"
"Encontrar y analizar el perfil de Instagram de The Rock"

Recopilación de Información Comercial

"Encontrar los 10 mejores restaurantes italianos en San Francisco"
"Extraer información de contacto de negocios de Google Maps en un área específica"

Soporte para la Creación de Contenido

"Proporcionar una guía paso a paso sobre el uso del protocolo de contexto del modelo y las URL de origen"
"Analizar las últimas tendencias de publicaciones en una página de Facebook"

Instalación y Configuración

Configuración de Claude Desktop

{
  "mcpServers": {
    "actors-mcp-server": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server"],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Configuración de Visual Studio Code

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apify_token",
        "description": "Apify API Token",
        "password": true
      }
    ],
    "servers": {
      "actors-mcp-server": {
        "command": "npx",
        "args": ["-y", "@apify/actors-mcp-server"],
        "env": {
          "APIFY_TOKEN": "${input:apify_token}"
        }
      }
    }
  }
}

Configuración de Actor Personalizado

{
  "command": "npx",
  "args": [
    "-y", "@apify/actors-mcp-server",
    "--actors", "lukaskrivka/google-maps-with-contact-details,apify/instagram-scraper"
  ],
  "env": {
    "APIFY_TOKEN": "your-apify-token"
  }
}

Requisitos del Sistema

Entorno Básico

  • Node.js: v18 o superior.
  • Sistema Operativo: macOS, Windows o Linux.
  • Apify API Token: Para acceder a los servicios de la plataforma Apify.

Requisitos del Cliente

  • Última versión de Claude Desktop.
  • Visual Studio Code (con soporte para la extensión MCP).
  • U otro cliente MCP compatible.

Limitaciones de Rendimiento

Configuración de Recursos

  • Límite de Memoria: Límite de 4GB de memoria por Actor.
  • Usuarios Gratuitos: Límite total de 8GB, con 128MB reservados para el servidor MCP.
  • Procesamiento Concurrente: Soporta la ejecución simultánea de múltiples Actors.

Optimización de la Arquitectura

  • Procesamiento de Esquemas: Compatibilidad con el estándar JSON Schema.
  • Optimización de la Descripción: Truncamiento y formateo automático.
  • Manejo de Errores: Mecanismo robusto de manejo de excepciones.

Desarrollo y Depuración

Herramienta de Inspector MCP

export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector npx -y @apify/actors-mcp-server

Clientes de Ejemplo

El proyecto proporciona código de ejemplo completo:

  • Cliente Stdio: examples/clientStdio.ts
  • Cliente SSE: examples/clientSse.ts

Resumen del Proyecto

El servidor MCP de Apify Actors representa un importante avance en la integración de herramientas para aplicaciones de IA, llevando potentes capacidades de extracción de datos a varias aplicaciones de IA a través del protocolo MCP estandarizado. El valor principal de este proyecto incluye:

Ventajas Clave

  1. Interfaz Unificada: Acceso a más de 200 herramientas de extracción de datos profesionales a través de un único protocolo.
  2. Despliegue Flexible: Soporta modos de despliegue en la nube y local.
  3. Amplia Compatibilidad: Integración con las principales herramientas y plataformas de desarrollo de IA.
  4. Fácil de Extender: Soporta la adición dinámica y la personalización de herramientas Actor.

Valor de la Aplicación

  • Mejora las Capacidades de la IA: Proporciona a las aplicaciones de IA la capacidad de obtener datos en tiempo real.
  • Simplifica la Integración: La interfaz estandarizada reduce la complejidad del desarrollo.
  • Expande las Posibilidades: La arquitectura abierta soporta una expansión ilimitada.
  • Listo para la Empresa: Plataforma madura y soporte de documentación completo.

Escenarios de Aplicación

  • Desarrollo de agentes de IA.
  • Análisis e investigación de datos.
  • Creación y gestión de contenido.
  • Inteligencia empresarial e investigación de mercado.
  • Recopilación automatizada de datos.

Este proyecto proporciona una solución potente, flexible y fácil de usar para las necesidades de adquisición de datos de las aplicaciones de IA, y es un componente importante en la pila de herramientas de IA moderna.