Hippycampus

Hippycampus

一个基于 LangChain 的 CLI 和 MCP 服务，支持动态加载 OpenAPI 规范并与 Langflow 集成。

前提条件

• Python 3.12.9
• UV 包管理器
• Google AI Studio API 密钥
• Langflow（用于创建可视化工作流）

安装

# 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

配置

Google AI Studio API 密钥

1. 访问 Google AI Studio
2. 点击右上角的“Create API Key”
3. 复制生成的密钥并将其设置为环境变量：

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

运行应用程序

CLI 模式（无 MCP 服务）

uv run hippycampus-cli

MCP 服务模式（SSE）

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

Langflow 服务

启动 Langflow 前，请确保 MCP 服务正在运行。

1. 设置组件路径环境变量：

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

2. 启动 Langflow 服务（开发模式下添加 --dev）：

uv run langflow run

3. 打开浏览器并访问 http://localhost:7860

在 Langflow 中使用自定义组件

1. 在 Langflow 界面中找到自定义组件：

   • OpenApi Service：用于加载 OpenAPI 规范
   • Hippycampus MCP Server：用于通过 SSE 连接 MCP 服务

2. 配置组件：

   • OpenApi Service：测试时使用 https://raw.githubusercontent.com/APIs-guru/unofficial_openapi_specs/master/xkcd.com/1.0.0/openapi.yaml
   • MCP Server：使用 http://localhost:8000/sse

请参阅录屏演示，了解操作指南。 录屏演示

请注意，官方 XKCD swagger 文件有误，将 comic_id 字段指定为数字而非整数；test 文件夹中提供了修正版本。

故障排除

• 身份验证错误：检查是否正确设置了 GOOGLE_API_KEY
• Langflow 中缺少组件：确认 LANGFLOW_COMPONENTS_PATH 指向正确的目录
• 连接问题：通过 Langflow 连接前，确保 MCP 服务正在运行
• 如果组件未显示在 Langflow 中，请尝试重启 Langflow 服务
• 在通过 MCP/Langflow 运行前，使用 CLI 调试 openapi_builder/spec_parser 和 Agent 交互问题。

许可证

MIT 许可证

版权所有 (c) 2024 Ray Cromwell

特此免费授予任何获得本软件及相关文档文件（“软件”）副本的人不受限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利，并允许获得本软件的人这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或重要部分中。

本软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和不侵权的保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任承担责任，无论该责任源于合同、侵权或其他原因，也无论其与本软件或本软件的使用或其他交易有关。