Hippycampus

基本能力

产品定位

Hippycampus是一个基于LangChain的CLI和MCP服务器，旨在支持动态加载OpenAPI规范并与Langflow集成，提供灵活的服务构建和调试能力。

核心功能

1. 动态加载OpenAPI规范：支持从URL加载OpenAPI规范，并动态生成服务接口。
2. Langflow集成：与Langflow无缝集成，支持可视化工作流创建。
3. CLI和MCP服务器模式：提供命令行界面和服务器模式，满足不同使用场景。
4. Google AI Studio API支持：支持通过Google AI Studio API进行认证和调用。

适用场景

1. API开发与调试：开发者可以使用Hippycampus快速加载和调试OpenAPI规范。
2. 可视化工作流创建：通过Langflow集成，用户可以创建和管理复杂的API工作流。
3. 自动化测试：支持通过CLI模式进行自动化测试和调试。

工具列表

1. hippycampus-cli：命令行工具，用于直接与OpenAPI服务交互。
2. hippycampus-server：MCP服务器，支持SSE传输模式，提供API服务。
3. Langflow：可视化工作流工具，用于创建和管理API工作流。

常见问题解答

1. 认证错误：检查GOOGLE_API_KEY环境变量是否设置正确。
2. Langflow组件缺失：确保LANGFLOW_COMPONENTS_PATH指向正确的目录。
3. 连接问题：确保MCP服务器在连接Langflow之前已启动。
4. 组件不显示：尝试重启Langflow服务器。

使用教程

使用依赖

1. Python 3.12.9：确保系统已安装Python 3.12.9。
2. UV包管理器：安装UV包管理器。
3. Google AI Studio API密钥：获取并设置Google AI Studio API密钥。
4. Langflow：安装Langflow以支持可视化工作流创建。

安装教程

# 安装UV包管理器
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # Windows用户使用: .venv\Scripts\activate

# 安装hippycampus及其依赖
uv pip install -e .

# 安装Langflow
uv pip install langflow

调试方式

1. CLI模式调试：

uv run hippycampus-cli

1. MCP服务器模式调试：

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

1. Langflow服务器调试：

uv run langflow run

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。