ヒッピーキャンパス

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キー

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 サーバー

Langflow を起動する前に、MCP サーバーが実行されていることを確認してください。

コンポーネントパス環境変数を設定します。

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

Langflow サーバーを起動します (開発モードの場合は --dev を追加します)。

uv run langflow run

ブラウザを開き、 http://localhost:7860にアクセスします。

Langflow でのカスタムコンポーネントの使用

Langflow UI で、カスタムコンポーネントを見つけます。
- OpenApi サービス: OpenAPI 仕様をロードするため
- Hippycampus MCP サーバー: SSE 経由で MCP サーバーに接続します
コンポーネントを構成します。
- OpenApi サービス: テストにはhttps://raw.githubusercontent.com/APIs-guru/unofficial_openapi_specs/master/xkcd.com/1.0.0/openapi.yamlを使用します
- MCP サーバー: http://localhost:8000/sseを使用します

ビジュアルガイドについては、スクリーンキャストデモをご覧ください。スクリーンキャストデモ

公式の XKCD swagger ファイルにはエラーが含まれており、comic_id フィールドが整数ではなく数値として指定されていることに注意してください。テストフォルダーには修正バージョンがあります。

トラブルシューティング

認証エラー: GOOGLE_API_KEYが正しく設定されているか確認してください
Langflow にコンポーネントがありません: LANGFLOW_COMPONENTS_PATHが正しいディレクトリを指していることを確認してください
接続の問題: Langflow 経由で接続する前に、MCP サーバーが実行中であることを確認してください。
Langflowにコンポーネントが表示されない場合は、Langflowサーバーを再起動してみてください。
MCP/Langflow で実行する前に、CLI を使用して openapi_builder/spec_parser とエージェントの相互作用の問題をデバッグします。

ライセンス

MITライセンス

本ソフトウェアおよび関連ドキュメントファイル (以下「本ソフトウェア」) のコピーを入手したすべての人物は、以下の条件に従い、本ソフトウェアを無制限に扱う権利 (使用、コピー、変更、統合、公開、配布、サブライセンス、および/または販売する権利を含みますが、これに限定されません) および本ソフトウェアの提供を受けた人物が同様の行為を行うことを許可する権利を無償で付与されます。

上記の著作権表示およびこの許可通知は、ソフトウェアのすべてのコピーまたは大部分に含めるものとします。

本ソフトウェアは「現状有姿」で提供され、明示的または黙示的を問わず、商品性、特定目的への適合性、非侵害性を含むがこれらに限定されない、いかなる種類の保証も付与されません。いかなる場合においても、著作者または著作権者は、契約違反、不法行為、またはその他の行為にかかわらず、本ソフトウェア、本ソフトウェアの使用、またはその他の取り扱いに起因または関連して発生するいかなる請求、損害、またはその他の責任についても責任を負わないものとします。