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

# Install UV if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

# Install hippycampus and its dependencies
uv pip install -e .

# Install langflow
uv pip install langflow

Configuración

Clave API de Google AI Studio

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

export GOOGLE_API_KEY='your-api-key-here'

Ejecución de las aplicaciones

Modo CLI (sin servidor MCP)

uv run hippycampus-cli

Modo de servidor MCP (SSE)

uv run hippycampus-server --transport sse --port 8000

Servidor Langflow

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

Establezca la variable de entorno de ruta de los componentes:

# Get your current working directory
pwd
# Use the output to set the components path
export LANGFLOW_COMPONENTS_PATH="/output/from/pwd/langflow/components"

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

uv run langflow run

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

Uso de componentes personalizados en Langflow

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
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

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.