Ollama-MCP Bridge WebUI

这是一个使用TypeScript实现的连接本地LLM（通过Ollama）到Model Context Protocol (MCP)服务器的桥梁，并提供了一个网页界面。此桥梁允许开源模型使用与Claude相同的工具和功能，从而能够在您自己的硬件上运行强大的本地AI助手。

特性

• 多MCP集成：同时连接多个MCP服务器
• 工具检测：根据查询自动识别应使用的工具
• 网页界面：简洁的用户界面，带有可折叠的工具描述
• 全面的工具集：文件系统、网络搜索和推理能力

安装

自动安装

设置桥梁最简单的方法是使用包含的安装脚本：

./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": {
      你的命令": "node",
      "参数": [
        "To/Your/Directory/Ollama-MCP-Bridge-WebUI/node_modules/@modelcontextprotocol/server-sequential-thinking/dist/index.js"
      ]
    }
  },
  "llm": {
    "模型": "qwen2.5-coder:7b-instruct-q4_K_M",
    "基础URL": "http://localhost:11434",
    "API密钥": "ollama",
    "温度": 0.7,
    "最大令牌数": 8000
  },
  "系统提示": "您是一个有用的助手，可以使用各种工具来帮助回答问题。您有三个主要工具组的访问权限：1) 文件系统操作 - 用于处理文件和目录，2) Brave搜索 - 用于在网络上查找信息，3) 顺序思维 - 用于复杂的问题解决。当用户提出需要外部信息、实时数据或文件操作的问题时，您应该使用工具而不是猜测或仅使用预训练的知识。"
}

2. .env 文件

此文件存储敏感信息，如API密钥：

# Brave搜索API密钥
BRAVE_API_KEY=your_brave_key_here

桥梁会自动将配置中的$BRAVE_API_KEY替换为您.env文件中的实际值。

使用

启动桥梁

只需运行：

./start.bat

这将启动带有网页界面的桥梁。

网页界面

在浏览器中打开http://localhost:8080（或控制台显示的端口）以访问网页界面。

许可证

MIT许可证 - 查看LICENSE文件获取详细信息