Ollama MCP Bridge WebUI

🚀 Ollama - MCP 橋接 WebUI

一個用 TypeScript 實現的橋樑工具，它能將本地大語言模型（通過 Ollama）連接到模型上下文協議（MCP）服務器，並且提供了一個網絡界面。藉助這個橋接工具，開源模型能夠擁有與 Claude 相同的能力，進而實現完全在您自己的硬件上運行的強大本地 AI 助手。

🚀 快速開始

運行橋接工具後，在您的網絡瀏覽器中訪問本地網頁即可使用。

✨ 主要特性

• 多 MCP 集成：可同時連接多個 MCP 服務器。
• 工具識別：能根據查詢自動識別應使用的工具。
• 網絡界面：帶有可摺疊工具描述的簡潔用戶界面。
• 全面工具集：涵蓋文件系統、網絡搜索和推理功能。

📦 安裝指南

自動安裝

最簡單的設置橋接工具的方法是使用包含的安裝腳本：

./install.bat

該腳本將執行以下操作：

1. 檢查並按需安裝 Node.js。
2. 檢查並按需安裝 Ollama。
3. 安裝所有依賴項。
4. 創建工作區目錄（../workspace）。
5. 設置初始配置。
6. 構建 TypeScript 項目。
7. 下載 Qwen 模型到 Ollama。

運行腳本後，您只需要執行以下操作：

1. 將 API 密鑰添加到 .env 文件中（配置文件中的 $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. 配置 API 密鑰到 .env 文件。
6. 構建項目：npm run build。

📚 詳細文檔

配置

橋接工具通過兩個主要文件進行配置：

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."
}

2. .env

存儲環境變量，例如 API 密鑰：

BRAVE_API_KEY=your_brave_api_key_here

使用

運行橋接工具：

./start.bat

📄 許可證

[在此處添加許可證信息，例如 MIT 或 GPL]

💬 貢獻與聯繫

貢獻

歡迎貢獻！請查看 CONTRIBUTING.md 以獲取更多信息。

聯繫方式

• GitHub：https://github.com/yourusername/ollama-mcp-bridge
• 郵件：contact@yourdomain.com
• 討論組：加入我們的 Discord 或其他聊天群組