Otter Bridge

🚀 OtterBridge

OtterBridgeは、アプリケーションを様々な大規模言語モデルプロバイダーに接続するための軽量で柔軟なサーバーです。このサーバーは、アプリケーションとLLM間の接続を簡素化し、異なるユースケースにも適応します。

📚 ドキュメント

🔍 文件構造

├── .env.example           # 環境変数のサンプルファイル
├── .gitignore             # Gitで無視するファイルを指定するファイル
├── LICENSE                # オープンソースライセンス（MIT、Apacheなど）
├── README.md              # プロジェクトのドキュメント
├── server.py              # MCPサーバーの実装（以前はfastmcp_server.pyと呼ばれていました）
├── requirements.txt       # Pythonの依存関係
└── src/                   # ソースコードのディレクトリ
    ├── __init__.py        # パッケージの初期化ファイル
    └── services/          # サービスのディレクトリ
        ├── __init__.py    # サービスの初期化コードを含むファイル
        └── ollama.py      # Ollamaサービスの実装

✨ 主な機能

• プロバイダー非依存：複数のLLMプロバイダーと連携するように設計されています（現在はOllamaをサポートし、近い将来ChatGPTとClaudeもサポート予定）。
• シンプルで組み合わせ可能な設計：LLMエージェントを構築するベストプラクティスに従っています。
• 軽量サーバー：FastMCPを使用して、信頼性と効率性の高いサーバーを実装しています。
• モデル管理：利用可能なモデルに関する情報と機能に簡単にアクセスできます。

❓ なぜ「OtterBridge」なのか？

カワウソが河岸間に架ける橋のように、OtterBridgeはあなたのアプリケーションと様々なLLMプロバイダーの間にシームレスな橋を架けます。カワウソと同じように適応性が高く、資源が豊富で、OtterBridgeは異なるLLMバックエンドに適応しながら、一貫したインターフェースを提供します。

📋 前提条件

OtterBridgeをインストールする前に、以下のものをインストールして実行する必要があります。

1. Ollama（https://ollama.ai/download）をデフォルトポートでインストールして実行する。
2. Pythonパッケージ管理にuv（https://github.com/astral-sh/uv）をインストールする。

📦 インストール

1. このリポジトリをクローンします。

git clone https://github.com/yourusername/otterbridge.git
cd otterbridge

2. uvを使用して依存関係をインストールします。

uv add -r requirements.txt

3. 提供されている .env.example を元に .env ファイルを作成します。

cp .env.example .env

4. .env ファイルで環境変数を設定します。

💻 使用例

基本的な使用法

OtterBridgeを起動する方法は2つあります。

1. テスト目的で手動起動：

uv run server:app -- host 0.0.0.0 port 8000

2. 本番環境で起動：

uv run server:app -- host 0.0.0.0 port 8000 -- reload off

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。

👏 謝辞

• MCP（モデルコンテキストプロトコル）：サーバーフレームワークの提供
• Ollama：ローカルLLMホストのサポート
• Anthropicの効果的なエージェント構築ガイド：アーキテクチャの啓発

🤝 貢献ガイド

貢献を歓迎します！自由にPull Requestを送信してください。

開発ガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m 'Add some amazing feature'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. Pull Requestを開きます。

📖 APIドキュメント

OtterBridgeが提供するインターフェースの使用方法については、APIドキュメント を参照してください。

⚙️ 統合方法

Claudeデスクトップを使用するユーザーは、Claudeデスクトップの設定にOtterBridgeを追加する必要があります。

1. Claudeデスクトップの設定ファイルを開きます。
2. 以下の設定を追加します（パスはローカルインストールに合わせて調整してください）。

"otterbridge": {
    "command": "uv",
    "args": [
        "--directory",
        "C:\\Path\\To\\Your\\otterbridge",
        "run",
        "server.py"
    ]
}