Servidor MCP Apollo.io

Una potente implementación de servidor de Protocolo de contexto de modelo (MCP) para una integración perfecta de la API de Apollo.io, que permite que los asistentes de IA interactúen con los datos de Apollo.io.

Descripción general

Este servidor MCP proporciona un conjunto completo de herramientas para interactuar con la API Apollo.io, lo que permite a los asistentes de IA:

• Enriquecer datos para personas y organizaciones
• Búsqueda de personas y organizaciones
• Encuentre ofertas de trabajo para organizaciones específicas
• Realice operaciones de Apollo.io sin salir de la interfaz de su asistente de IA

¿Por qué utilizar este servidor MCP?

• Integración perfecta con IA : conecta tus asistentes de IA directamente a los datos de Apollo.io
• Operaciones de API simplificadas : realice tareas comunes de Apollo.io mediante comandos de lenguaje natural
• Acceso a datos en tiempo real : obtenga información actualizada de Apollo.io
• Autenticación segura : utiliza la autenticación de token de API segura de Apollo.io
• Diseño extensible : agregue fácilmente más capacidades de API de Apollo.io según sea necesario

Instalación

Configuración

El servidor requiere un token de acceso a la API de Apollo.io. Puedes obtenerlo de la siguiente manera:

1. Accediendo a su cuenta de Apollo.io
2. Navegando a Configuración > API
3. Generar una clave API

Puedes proporcionar el token de dos maneras:

1. Como variable de entorno:
   APOLLO_IO_API_KEY=your-api-key
2. Como argumento de línea de comandos:
   npm start -- --api-key=your-api-key

Para el desarrollo, cree un archivo .env en la raíz del proyecto para almacenar sus variables de entorno:

Uso

Iniciando el servidor

Implementación de la autenticación en el servidor SSE

El servidor SSE utiliza el paquete mcp-proxy-auth para la autenticación. Para implementar la autenticación:

1. Instalar el paquete:
   npm install mcp-proxy-auth
2. Establezca la variable de entorno AUTH_SERVER_URL para que apunte al punto final de verificación de su clave API:
   export AUTH_SERVER_URL=https://your-auth-server.com/verify
3. Ejecute el servidor SSE con autenticación:
   npx mcp-proxy-auth node dist/index.js
4. La URL de SSE estará disponible en:
   localhost:8080/sse?apiKey=apikey
   Reemplace apikey con su clave API real para la autenticación.

El paquete mcp-proxy-auth actúa como un proxy que:

• Intercepta solicitudes a su servidor SSE
• Verifica las claves API con su servidor de autenticación
• Solo permite que las solicitudes autenticadas lleguen a su punto final SSE

Integración con asistentes de IA

Este servidor MCP está diseñado para funcionar con asistentes de IA compatibles con el Protocolo de Contexto de Modelo. Una vez en funcionamiento, el servidor expone un conjunto de herramientas que los asistentes de IA compatibles pueden usar para interactuar con los datos de Apollo.io.

Herramientas disponibles

El servidor expone las siguientes potentes herramientas de integración de Apollo.io:

1. enriquecimiento de personas
   • Utilice el punto final de enriquecimiento de personas para enriquecer los datos de una persona
   • Parámetros:
     • first_name (cadena, opcional): nombre de la persona
     • last_name (cadena, opcional): apellido de la persona
     • email (cadena, opcional): dirección de correo electrónico de la persona
     • domain (cadena, opcional): dominio de la empresa
     • organization_name (cadena, opcional): nombre de la organización
   • Ejemplo:
     { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com" }
2. enriquecimiento de la organización
   • Utilice el punto final de enriquecimiento de la organización para enriquecer los datos de una empresa
   • Parámetros:
     • domain (cadena, opcional): dominio de la empresa
     • name (cadena, opcional): nombre de la empresa
   • Ejemplo:
     { "domain": "apollo.io" }
3. búsqueda de personas
   • Utilice el punto final de búsqueda de personas para encontrar personas
   • Parámetros:
     • q_organization_domains_list (matriz, opcional): Lista de dominios de la organización en los que buscar
     • person_titles (matriz, opcional): lista de títulos de trabajo para buscar
     • person_seniorities (matriz, opcional): Lista de niveles de antigüedad para buscar
   • Ejemplo:
     { "person_titles": ["Marketing Manager"], "person_seniorities": ["vp"], "q_organization_domains_list": ["apollo.io"] }
4. búsqueda de organización
   • Utilice el punto final de búsqueda de organizaciones para encontrar organizaciones
   • Parámetros:
     • q_organization_domains_list (matriz, opcional): Lista de dominios de organización para buscar
     • organization_locations (matriz, opcional): lista de ubicaciones de organizaciones para buscar
   • Ejemplo:
     { "organization_locations": ["Japan", "Ireland"] }
5. ofertas de trabajo de la organización
   • Utilice el punto final Publicaciones de empleo de la organización para encontrar publicaciones de empleo para una organización específica
   • Parámetros:
     • organization_id (cadena, obligatoria): ID de la organización de Apollo.io
   • Ejemplo:
     { "organization_id": "5e60b6381c85b4008c83" }

Ampliación del servidor

El servidor está diseñado para ser fácilmente extensible. Para añadir nuevas funciones de la API de Apollo.io:

1. Agregue nuevos métodos a la clase ApolloClient en src/apollo-client.ts
2. Registra nuevas herramientas en el método setupToolHandlers en src/index.ts
3. Reconstruir el proyecto con npm run build

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Palabras clave

Apollo.io, Protocolo de Contexto de Modelo, MCP, Asistente de IA, TypeScript, Integración de API, API de Apollo.io, Enriquecimiento de Personas, Enriquecimiento de Organizaciones, Búsqueda de Personas, Búsqueda de Organizaciones, Ofertas de Empleo, Herramientas de IA