Hippycampus

Hippycampus是一個基於LangChain的CLI和MCP服務器，支持動態加載OpenAPI規範並與Langflow集成，提供可視化工作流創建功能。

開發者工具人工智能聊天機器人 #API集成 #工作流工具 #LangChain .Python

評分 : 2.5分

下載量 : 25

更新時間 : 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.