Hippycampus

Hippycampus是一个基于LangChain的CLI和MCP服务器，支持动态加载OpenAPI规范并与Langflow集成，提供可视化工作流创建功能。

开发者工具人工智能聊天机器人 #API集成 #工作流工具 #LangChain .Python

评分 : 2.5分

下载量 : 21

更新时间 : 2025-04-28

什么是Hippycampus MCP服务器？

Hippycampus MCP服务器是一个用于模型交互的协议服务器，它允许用户通过流式传输的方式与AI模型进行实时通信。它支持动态加载外部API规范，并且可以与可视化工具Langflow无缝集成。

如何使用Hippycampus MCP服务器？

要开始使用Hippycampus MCP服务器，您需要安装必要的依赖项并启动服务器。然后，您可以将其与Langflow配合使用来创建自定义的工作流程。

适用场景

适用于需要实时响应的应用程序，例如聊天机器人、数据分析工具以及任何需要高效处理大量请求的场景。

主要功能

支持流式传输通过SSE（Server-Sent Events）实现高效的流式数据传输。

动态加载OpenAPI规范能够自动加载外部API文档，简化了API集成过程。

与Langflow集成提供了强大的可视化编辑器，便于构建复杂的业务逻辑。

优势与局限性

优势

实时性强，适合高并发环境。

易于扩展，支持多种类型的API集成。

提供直观的用户界面，降低开发门槛。

局限性

对网络环境有一定要求，可能影响性能。

初次设置可能稍显复杂，需要一定的技术基础。

如何使用

安装依赖项

确保已安装Python 3.12.9及UV包管理器。

启动MCP服务器

运行命令以启动Hippycampus MCP服务器。

配置Langflow

设置LANGFLOW_COMPONENTS_PATH环境变量并启动Langflow。

使用案例

案例标题在Langflow中使用Hippycampus MCP服务器创建一个简单的聊天机器人。

案例标题通过OpenAPI规范加载外部API并在Langflow中调用。

常见问题

如何获取Google AI Studio API密钥？

如果Langflow组件未显示怎么办？

🚀 骑士海马

骑士海马是一个基于LangChain的CLI和MCP服务器，支持动态加载OpenAPI规范并与Langflow集成，为用户提供便捷的操作和强大的功能。

🚀 快速开始

在开始使用骑士海马之前，你需要满足以下先决条件，并按照安装步骤进行操作。

✅ 先决条件

Python 3.12.9
UV包管理器
Google AI Studio API密钥
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

⚙️ 配置

Google AI Studio API密钥

访问Google AI Studio
点击右上角的“创建API密钥”
复制生成的密钥并设置为环境变量：

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服务器

确保MCP服务器正在运行，再启动Langflow。

设置组件路径环境变量：

# 获取当前工作目录
pwd
# 使用输出设置组件路径
export LANGFLOW_COMPONENTS_PATH="/output/from/pwd/langflow/components"

启动Langflow服务器（添加--dev进入开发模式）：

uv run langflow run

打开浏览器，导航到 http://localhost:7860

使用自定义组件在Langflow中

在Langflow UI中定位自定义组件：
- OpenApi Service：用于加载OpenAPI规范
- Hippycampus MCP服务器：用于通过SSE连接到MCP服务器
配置组件：
- 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字段指定为数字而不是整数，在测试文件夹中有一个修复版本。

❓ 故障排除

认证错误：检查GOOGLE_API_KEY是否正确设置
Langflow中缺少组件：确认LANGFLOW_COMPONENTS_PATH指向正确的目录
连接问题：确保MCP服务器正在运行后再通过Langflow连接
如果组件未在Langflow中显示，请尝试重新启动Langflow服务器
在运行MCP/Langflow之前，使用cli调试openapi_builder/spec_parser和代理交互问题

📄 许可证

本项目采用MIT License。

准许任何人免费获取本软件及关联文档文件（“软件”），不受限制地处理、复制、修改、合并、分发、分发、 sublicense以及出售该软件的副本，同时允许向获得该软件的人提供处理该软件的权利。

软件按“原样”提供，不做任何明示或暗示的保证，包括但不限于对适销性、特定用途的适用性和不侵权的保证。无论是在合同行为、侵权行为或其他行为中，作者或版权持有者均不对因使用本软件而产生的任何声明、损害或其它责任负责。

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.