Ollama MCP 怎么配：3 步启动并验证桥接服务

早八人 技术创作者 2026-11-01 16 阅读

Ollama MCP 桥接能把 Ollama 与 MCP 工具连接起来，供模型调用外部能力。

截至 2026-09-24，官方 ollama-js 仓库仍以 JavaScript 客户端和 Ollama REST API 为核心；本次可核实的 MCP 操作路径来自 ollama-mcp-bridge。现在值得按这条路径配置，是因为它明确把配置文件位置、启动参数和连接检查拆开了，适合直接排查“模型连不上工具”的问题。

先分清：Ollama 和 MCP 桥接不是同一个程序

Ollama 负责运行模型。MCP（Model Context Protocol，模型上下文协议）负责规定模型与应用、工具及数据源通信的接口。MCP 桥接则位于两者之间，把 MCP 服务器暴露的工具交给 Ollama 调用。

Ollama JavaScript 官方仓库提供的是 JavaScript 调用库，安装方式是 npm i ollama，其 README 示例调用 chat 接口，并没有给出 mcp-config.json 的配置说明。因此，本文不把 JavaScript 客户端当作 MCP 配置入口，而是使用独立的 ollama-mcp-bridge。

组件 作用 关键入口 本文是否需要
Ollama 运行本地模型、提供 REST API ollama serve 需要
ollama-js 在 JavaScript 中调用 Ollama npm i ollama 仅在开发 Node.js 客户端时需要
ollama-mcp-bridge 收集 MCP 工具并接入 Ollama mcp-config.json 本文重点

（此归类按各项目公开 README 整理，不是 Ollama 官方声明。）桥接项目的 Quick Start 明确要求三项前置：Ollama 正在运行、配置文件中至少有一个 MCP 服务器、桥接程序已安装。

开始前准备：只检查这 3 项

  1. 安装并启动 Ollama。 在终端运行 ollama --version；能够显示版本号后再执行 ollama serve。如果命令不存在，先从 Ollama 官方渠道安装客户端。

  2. 安装桥接程序。 运行 ollama-mcp-bridge --version。成功时应返回程序版本；如果提示找不到命令，需要先把该工具安装到当前终端的 PATH 中。

  3. 准备 MCP 配置。 进入准备存放配置的目录，确认文件名为 mcp-config.json，且其中存在 mcpServers 节点。桥接程序默认读取当前目录下的这个文件；也可通过 --config 指定其他路径。

下面使用本地 Ollama，默认连接地址是 http://localhost:11434。如果 Ollama 位于另一台机器，桥接启动时再用 --ollama-url 改成实际地址。

按这 3 步启动并接入 MCP

1. 启动 Ollama

在一个终端窗口运行：

ollama serve

保持这个窗口运行。另开一个终端访问 Ollama 的本地接口；只要接口返回内容，就说明 Ollama 服务已经可访问，而不是仅仅“命令装好了”。

桥接程序会在绑定自身端口之前检查 Ollama 健康状态，因此不要在 ollama serve 尚未就绪时启动桥接。这里最容易产生的误解是：模型明明已经下载到电脑里，并不代表后台服务正在运行。

2. 写入 MCP 配置

在桥接程序默认读取的位置创建 mcp-config.json。可以从桥接仓库的 Quick Start 配置示例复制完整文件，再按实际 MCP 服务器修改。

示例使用一个模拟天气服务器，配置中的关键内容包括：

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "./mock-weather-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "MCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

上面就是仓库 Quick Start 的完整示例，可以直接存成 mcp-config.json。唯一要提前准备的是 command 里的 uv（Python 包工具，pipx install uv 或见 uv 官方安装页）；换成自己的 MCP 服务器时，weather 这个名字可以随便改，command/args 换成对方 README 给的启动方式即可。

路径规则尤其容易踩坑。示例里的 ./mock-weather-mcp-server 相对于 mcp-config.json 所在目录解析，不是相对于启动桥接时所在的终端目录。配置文件可以移动，但移动后要同步修正相对路径；不想处理路径关系时，优先改用绝对路径。

3. 启动桥接程序

在配置文件所在目录运行：

ollama-mcp-bridge

这一步使用三项默认值：配置文件 ./mcp-config.json、监听地址 0.0.0.0、端口 8000，同时连接本地 http://localhost:11434。

如果配置文件不在当前目录，可直接复制执行：

ollama-mcp-bridge --config /path/to/custom-config.json

如果 Ollama 不在本机，则执行：

ollama-mcp-bridge --config /path/to/custom-config.json --host 0.0.0.0 --port 8080 --ollama-url http://remote-ollama:11434

这条命令同时覆盖配置路径、桥接端口和 Ollama 地址，适合作为排查模板。0.0.0.0 表示监听所有可用网络接口；如果桥接机处于不可信网络，不要直接暴露该端口。

怎么确认 MCP 工具真的接上了

启动日志没有立即退出，并且桥接程序完成 MCP 服务器连接、工具收集，才算第一步通过。Quick Start 对启动过程的描述是：连接每个已配置的 MCP 服务器，收集其工具，再把工具交给 Ollama。

可以分三层检查：

检查层 立即可执行的操作 通过标志
Ollama 服务 在另一终端请求本地 Ollama API 接口返回内容，不再出现连接拒绝
桥接程序 运行 ollama-mcp-bridge --version 输出桥接程序版本
工具连接 启动 ollama-mcp-bridge 进程持续运行，没有在健康检查或加载配置时退出

最后让客户端连接桥接服务的 8000 端口，发起一次确实需要 MCP 工具的对话。如果模型只回答“无法调用工具”，但桥接进程仍在运行，问题通常位于工具暴露或客户端连接层，而不是 Ollama 模型本身。

常见卡点：配置没错，工具仍不出现

一个真实 GitHub issue 的标题是 “MCP not showing in Claude”。对应排查思路不是反复改模型，而是依次处理路径、日志和重启：确认配置文件位置，使用绝对路径，查看日志，完全重启 Claude Desktop，再用最小配置测试。

相关项目给出的调试入口可以执行：

curl http://localhost:11434/api/generate -d '{
  "model": "llama2:7b",
  "prompt": "hello",
  "stream": false
}'
MCP_LOG_LEVEL=debug npm start 2>&1 | tee debug.log

第一段用于确认 Ollama 自身是否能响应生成请求；第二段把桥接日志写入 debug.log，其中 debug 级别便于看到 MCP 加载过程。若测试后报模型不存在，把命令中的模型名换成本机实际已经拉取的模型。

另一个常见误区是只启动了 Ollama 窗口，却忘了桥接进程。两者必须同时运行：终端 A 保持 ollama serve，终端 B 执行 ollama-mcp-bridge。如果改用自定义端口，还要保证启动参数中的桥接端口与客户端连接端口一致。

延伸入口：按问题查原始说明

安装与版本文件可查看 PyPI 上的 ollama-mcp-bridge 0.8.0 页面，其中列出了 --config、--host、--port、--ollama-url 和 --max-tool-rounds 等参数。

完整启动顺序与配置示例见 桥接项目 Quick Start。需要在 Node.js 程序里直接调用 Ollama，而不是通过 MCP 桥接时，再参考 Ollama JavaScript 官方仓库。

判断是否配置成功，可以记住这条最短路径：ollama serve 有响应、ollama-mcp-bridge --version 能运行、桥接启动后持续收集 MCP 工具，并且一次实际工具调用成功。四处同时成立，才算完整接通。

参考来源

# AI# 知识

评论区

0 条评论

登录后可评论。

早八人 16 阅读