Ollama-MCP Bridge WebUI

Ollama-MCP Bridge WebUI

Ollama を介してローカル LLM を Model Context Protocol（MCP）サーバーに接続する、Web インターフェース付きの TypeScript 実装です。このブリッジを使うと、オープンソースモデルが Claude と同じツールや機能を利用できるため、お使いのハードウェア上だけで動作する強力なローカル AI アシスタントを実現できます。

機能

• 複数の MCP との連携：複数の MCP サーバーに同時に接続できます
• ツールの検出：クエリに基づいて使用するツールを自動的に特定します
• Web インターフェース：ツールの説明を折りたたみ可能な、すっきりした UI
• 充実したツールセット：ファイルシステム、Web 検索、推論機能

セットアップ

自動インストール

ブリッジをセットアップする最も簡単な方法は、同梱のインストールスクリプトを使用することです。

./install.bat

このスクリプトは次の処理を行います。

1. Node.js が必要かどうかを確認し、必要に応じてインストールします
2. Ollama が必要かどうかを確認し、必要に応じてインストールします
3. すべての依存関係をインストールします
4. ワークスペースディレクトリ（../workspace）を作成します
5. 初期設定を行います
6. TypeScript プロジェクトをビルドします
7. Ollama 用の Qwen モデルをダウンロードします

スクリプトの実行後は、次の作業だけが必要です。

1. .env ファイルに API キーを追加します（設定内の $VARIABLE_NAME 参照は実際の値に置き換えられます）

手動セットアップ

手動でセットアップする場合は、次の手順に従ってください。

1. ollama.com/download から Ollama をインストールします
2. Qwen モデルを取得します：ollama pull qwen2.5-coder:7b-instruct-q4_K_M
3. 依存関係をインストールします：npm install
4. ワークスペースディレクトリを作成します：mkdir ../workspace
5. .env で API キーを設定します
6. プロジェクトをビルドします：npm run build

設定

ブリッジは主に次の 2 つのファイルで設定します。

1. bridge_config.json

このファイルでは、MCP サーバー、LLM の設定、システムプロンプトを定義します。環境変数は $VARIABLE_NAME の形式で参照します。

例：

{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": [
        "To/Your/Directory/Ollama-MCP-Bridge-WebUI/node_modules/@modelcontextprotocol/server-filesystem/dist/index.js",
        "To/Your/Directory/Ollama-MCP-Bridge-WebUI/../workspace"
      ],
      "allowedDirectory": "To/Your/Directory/Ollama-MCP-Bridge-WebUI/../workspace"
    },
    "brave-search": {
      "command": "node",
      "args": [
        "To/Your/Directory/Ollama-MCP-Bridge-WebUI/node_modules/@modelcontextprotocol/server-brave-search/dist/index.js"
      ],
      "env": {
        "BRAVE_API_KEY": "$BRAVE_API_KEY"
      }
    },
    "sequential-thinking": {
      "command": "node",
      "args": [
        "To/Your/Directory/Ollama-MCP-Bridge-WebUI/node_modules/@modelcontextprotocol/server-sequential-thinking/dist/index.js"
      ]
    }
  },
  "llm": {
    "model": "qwen2.5-coder:7b-instruct-q4_K_M",
    "baseUrl": "http://localhost:11434",
    "apiKey": "ollama",
    "temperature": 0.7,
    "maxTokens": 8000
  },
  "systemPrompt": "You are a helpful assistant that can use various tools to help answer questions. You have access to three main tool groups: 1) Filesystem operations - for working with files and directories, 2) Brave search - for finding information on the web, 3) Sequential thinking for complex problem-solving. When a user asks a question that requires external information, real-time data, or file manipulation, you should use a tool rather than guessing or using only your pre-trained knowledge."
}

2. .env ファイル

このファイルには、API キーなどの機密情報を保存します。

# Brave Search API key
BRAVE_API_KEY=your_brave_key_here

ブリッジは、設定内の $BRAVE_API_KEY を .env ファイルに記載された実際の値に自動的に置き換えます。

使い方

ブリッジの起動

次のコマンドを実行します。

./start.bat

Web インターフェース付きでブリッジが起動します。

Web インターフェース

ブラウザーで http://localhost:8080（またはコンソールに表示されたポート）を開くと、Web インターフェースにアクセスできます。

ライセンス

MIT ライセンス — 詳細は LICENSE ファイルを参照してください