Hippycampus

Hippycampus

OpenAPI 仕様の動的な読み込みと Langflow との統合に対応した、LangChain ベースの CLI および MCP サーバーです。

前提条件

• 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 の UI で、カスタムコンポーネントを探します：

   • 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 とエージェントの連携に関する問題をデバッグしてください。

ライセンス

MIT ライセンス

Copyright (c) 2024 Ray Cromwell

本ソフトウェアおよび関連文書ファイル（以下「ソフトウェア」）の複製を取得するすべての人に対し、ソフトウェアを無制限に扱うことを無償で許可します。これには、使用、複製、変更、統合、公開、配布、サブライセンス、および／または販売する権利が含まれます。また、ソフトウェアを提供する人に同様の権利を許可することもできます。ただし、以下の条件に従うものとします。

上記の著作権表示および本許諾表示は、ソフトウェアのすべての複製または重要な部分に含めるものとします。

本ソフトウェアは「現状のまま」提供され、明示的か黙示的かを問わず、商品性、特定目的への適合性および権利非侵害の保証を含め、いかなる保証もありません。作者または著作権者は、契約行為、不法行為、その他の行為に起因するかを問わず、本ソフトウェアまたはその使用その他の取引に起因または関連して発生したいかなる請求、損害、その他の責任についても責任を負いません。