Hippycampus MCP Server

Hippycampus

Un servidor CLI y MCP basado en LangChain que admite la carga dinámica de especificaciones OpenAPI y la integración con Langflow.

Prerrequisitos

• Python 3.12.9
• Gestor de paquetes UV
• Clave API de Google AI Studio
• Langflow (para la creación de flujos de trabajo visuales)

Instalación

Configuración

Clave API de Google AI Studio

1. Visita Google AI Studio
2. Haga clic en "Crear clave API" en la parte superior derecha.
3. Copie la clave generada y configúrela como una variable de entorno:

Ejecución de las aplicaciones

Modo CLI (sin servidor MCP)

Modo de servidor MCP (SSE)

Servidor Langflow

Asegúrese de que el servidor MCP esté ejecutándose antes de iniciar Langflow.

1. Establezca la variable de entorno de ruta de los componentes:

2. Inicie el servidor Langflow (agregue --dev para el modo de desarrollo):

3. Abra su navegador y navegue a http://localhost:7860

Uso de componentes personalizados en Langflow

1. En la interfaz de usuario de Langflow, busque los componentes personalizados:
   • Servicio OpenAPI: para cargar especificaciones OpenAPI
   • Servidor MCP de Hippycampus: para conectarse al servidor MCP a través de SSE
2. Configurar los componentes:
   • Servicio OpenApi: utilice https://raw.githubusercontent.com/APIs-guru/unofficial_openapi_specs/master/xkcd.com/1.0.0/openapi.yaml para realizar pruebas
   • Servidor MCP: utilice http://localhost:8000/sse

Vea la demostración de Screencast para obtener una guía visual. Demostración de Screencast

Tenga en cuenta que los archivos swagger oficiales de XKCD contienen un error y especifican el campo comic_id como un número en lugar de un entero; hay una versión corregida en la carpeta de prueba.

Solución de problemas

• Errores de autenticación: Compruebe si GOOGLE_API_KEY está configurado correctamente
• Componentes faltantes en Langflow: Verifique que LANGFLOW_COMPONENTS_PATH apunte al directorio correcto
• Problemas de conexión: asegúrese de que el servidor MCP esté en ejecución antes de conectarse a través de Langflow
• Si los componentes no aparecen en Langflow, intente reiniciar el servidor Langflow
• Utilice la CLI para depurar problemas de interacción del agente y openapi_builder/spec_parser antes de ejecutar en MCP/Langflow.

Licencia

Licencia MIT

Derechos de autor (c) 2024 Ray Cromwell

Por la presente se concede permiso, sin cargo, a cualquier persona que obtenga una copia de este software y los archivos de documentación asociados (el "Software"), para tratar el Software sin restricción, incluyendo, sin limitación, los derechos a usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y/o vender copias del Software, y para permitir que las personas a quienes se les proporciona el Software lo hagan, sujeto a las siguientes condiciones:

El aviso de derechos de autor anterior y este aviso de permiso se incluirán en todas las copias o partes sustanciales del Software.

EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO, ENTRE OTRAS, LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN FIN DETERMINADO Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE LOS DERECHOS DE AUTOR SERÁN RESPONSABLES DE NINGUNA RECLAMACIÓN, DAÑOS U OTRAS RESPONSABILIDADES, YA SEA EN ACCIÓN CONTRACTUAL, EXTRACONTRACTUAL O DE OTRO TIPO, QUE SURJA DE, SE DERIVE DE O EN RELACIÓN CON EL SOFTWARE O EL USO U OTRAS RELACIONES CON EL MISMO.