🚀 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 或其他聊天群组