Ollama-MCP 桥接 WebUI

一个 TypeScript 实现，通过 Web 界面将本地 LLM（通过 Ollama）连接到模型上下文协议 (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 服务器、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 文件