Ollama-MCP Bridge WebUI

Ollama-MCP Bridge WebUI

一个使用 TypeScript 实现的项目，通过 Web 界面将本地大模型（借助 Ollama）连接到 Model Context Protocol（MCP）服务。该桥接程序让开源模型也能使用与 Claude 相同的工具和功能，从而打造完全运行在自有硬件上的强大本地 AI 助手。

功能

• 多 MCP 集成：同时连接多个 MCP 服务
• 工具检测：根据查询自动识别要使用的工具
• Web 界面：简洁的 UI，支持折叠工具描述
• 全面的工具集：具备文件系统、网络搜索和推理功能

设置

自动安装

设置桥接程序最简单的方式是使用附带的安装脚本：

./install.bat

此脚本将：

1. 检查并在需要时安装 Node.js
2. 检查并在需要时安装 Ollama
3. 安装所有依赖项
4. 创建工作区目录（../workspace）
5. 设置初始配置
6. 构建 TypeScript 项目
7. 为 Ollama 下载 Qwen 模型

运行脚本后，你只需：

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. 在 .env 中配置 API 密钥
6. 构建项目：npm run build

配置

桥接程序通过两个主要文件进行配置：

1. bridge_config.json

此文件用于定义 MCP 服务、大模型设置和系统提示词。环境变量使用 $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 - 详情请参阅 LICENSE 文件