Hippycampus

🚀 騎士海馬

LangChainに基づくCLIとMCPサーバーで、OpenAPI仕様を動的に読み込み、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キー

1. Google AI Studioにアクセスします。
2. 右上の「APIキーを作成」をクリックします。
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サーバー

MCPサーバーが実行中であることを確認してから、Langflowを起動します。

1. コンポーネントパスの環境変数を設定します：

# 現在の作業ディレクトリを取得します
pwd
# 出力を使用してコンポーネントパスを設定します
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サーバー：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フィールドを数字ではなく整数として指定するエラーがあります。テストフォルダに修正版があります。

トラブルシューティング

• 認証エラー：GOOGLE_API_KEYが正しく設定されていることを確認してください。
• Langflowでコンポーネントが欠落している：LANGFLOW_COMPONENTS_PATHが正しいディレクトリを指していることを確認してください。
• 接続問題：MCPサーバーが実行中であることを確認してから、Langflowを介して接続してください。
• コンポーネントがLangflowに表示されない場合は、Langflowサーバーを再起動してみてください。
• MCP/Langflowを実行する前に、cliでopenapi_builder/spec_parserとプロキシの相互作用の問題をデバッグしてください。

📄 ライセンス

MITライセンス

Copyright (c) 2024 Ray Cromwell

このソフトウェアおよび関連ドキュメントファイル（「ソフトウェア」）のコピーを無償で取得するすべての人に対して、制限なく取り扱うことを許可します。ソフトウェアのコピーをコピー、修正、統合、配布、サブライセンス、および販売することができ、ソフトウェアを取得した人に対しても同様の取り扱いを許可することができます。

上記の著作権表示およびこの許諾表示は、すべてのコピーまたは重要な部分に含まれるものとします。

ソフトウェアは「現状のまま」提供され、明示的または暗示的な保証を一切伴わず、商品性、特定の目的への適合性、および非侵害の保証を含みません。契約行為、不法行為、またはその他の行為において、著者または著作権所有者は、ソフトウェアの使用またはその他の取り扱いに起因する、または関連するすべての請求、損害、またはその他の責任について責任を負いません。

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.