Osmosis-MCP-4B

Osmosis-MCP-4B

ブログ記事

前提条件

• Python 3.x
• uvx
• モデルサーバーへのアクセス（例：vLLM/lm studio で ローカル実行）
• 以下の API キー：
  • Brave Search
  • Google Maps
  • AccuWeather

セットアップ＆インストール

0. ここから LM studio をインストールし、http エンドポイント経由でモデルを実行します

   1. discover でモデルを見つけてダウンロードします
   2. 読み込むモデルを選択し、osmosis モデルを読み込みます
   3. モデルを読み込んだ状態でウェブサーバーを起動します

1. リポジトリをクローンします（該当する場合）：

   git clone https://github.com/Gulp-AI/Osmosis-MCP-4B-demo
   cd Osmosis-MCP-4B-demo
   

2. 依存関係をインストールします： 仮想環境を使用することをお勧めします。

   python -m venv .venv
   source .venv/bin/activate  # Windows の場合: .venv\Scripts\activate
   pip install -r requirements.txt
   

3. 環境変数をセットアップします： プロジェクトディレクトリのルートに .env ファイルを作成し、API キーとモデルサーバーの設定を追加します：

   BRAVE_API_KEY="your_brave_api_key"
   GOOGLE_MAPS_API_KEY="your_google_maps_api_key"
   ACCUWEATHER_API_KEY="your_accuweather_api_key"
   APP_STYLE="gui" # または "tui"
   

   API キーが提供されていない場合、ツールは読み込まれません。 APP_STYLE が省略されている場合、アプリケーションはデフォルトで GUI モードになります。 main.py スクリプトは現在、モデルサーバー URL を直接設定します。http://localhost:1234/v1 が Qwen モデルサーバーの正しいエンドポイントであることを確認してください（これが lm studio で使用するものです）。

4. ローカルモデルを提供します： lm studio のようなツールを使用して、使用可能なエンドポイントを提供します。

環境変数

アプリケーションは以下の環境変数を使用します（.env ファイルから読み込まれます）：

• BRAVE_API_KEY：Brave Search の API キー。
• GOOGLE_MAPS_API_KEY：Google Maps の API キー。
• ACCUWEATHER_API_KEY：AccuWeather の API キー。
• APP_STYLE：'tui' または 'gui'

利用可能なツール（MCP サーバー）

エージェントは MCP 経由で以下のツールを使用するよう設定されています：

• Time： 現在の時刻情報を提供します。
• Brave Search： ウェブ検索機能を有効にします。
  • 必須：BRAVE_API_KEY
• Fetch： URL からコンテンツを取得します。
• Google Maps： ロケーションベースのサービスを提供します。
  • 必須：GOOGLE_MAPS_API_KEY
• Weather： 天気予報を提供します。
  • 必須：ACCUWEATHER_API_KEY
• Code Interpreter： Python コードスニペットを実行するための組み込みツール。

これらのサーバーは実行中で、エージェントがそれぞれの機能を利用するためにアクセス可能である必要があります。main.py スクリプトは、これらの MCP サーバーを起動するコマンドを提供します。

グラフィカルユーザーインターフェース（GUI）の実行方法：

このモードは、エージェントと対話するためのウェブベースのインターフェースを起動します。これがデフォルトモードです。
```bash
python main.py
```

ウェブ UI は起動時に `WebUI` コンポーネントによって提供されたアドレス（`http://localhost:7860`）でアクセス可能になります。

---