让 GPT、Gemini、DeepSeek 或本地模型使用 MCP 服务器

MCP 服务器连接的是 agent harness,而不是模型,所以任何能调用工具的模型都能用它们。在 OHarness 里,你只需在 ~/.oharness/mcp.json 里声明一次服务器,它的工具就会提供给当前运行的模型,无论会话中途是否切换过模型。

更新于

为什么跟模型无关

MCP 服务器对外提供工具。harness 连接到它,列出这些工具,再以与内置工具相同的工具调用格式提供给模型——命名空间为 mcp__<server>__<tool>。模型看到的只有工具定义;它自己从不直接使用 MCP 协议。所以同一个服务器在 Claude、GPT、Gemini、DeepSeek 或本地 Qwen 下都能用。

声明一个服务器

两种传输方式都已内置——本地进程用 stdio,远程服务器用 Streamable HTTP——底层没有用 MCP SDK。把声明写进 ~/.oharness/mcp.json:

{
  "mcpServers": {
    "fs": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": { "authorization": "Bearer ${env:GITHUB_TOKEN}" },
      "allowedTools": ["search_*", "get_*"]
    }
  }
}

${env:NAME} 在服务器启动时才解析,所以文件里永远不含密钥,可以分享或提交。如果某个变量没有设置,会在尝试连接之前就指出来。allowedTools 用来缩小服务器可以提供的工具范围。

配合任意模型使用

oharness -m openai/gpt-5.4-mini

在会话里,/mcp 会列出每个服务器及其工具数量。用 /model google/gemini-3.6-flash 或 /model ollama/qwen3-coder:30b 切换后,同样的工具依然都在。在浏览器和桌面应用里,输入框的 **+** 菜单会列出连接器,点一下就能连接;需要 OAuth 的远程服务器会在你的浏览器里打开登录页。

给 MCP 工具套上缰绳

MCP 工具和内置工具走同一套权限规则,按名称匹配。只读工具可以放行,写操作则保留确认:

{
  "allow": ["mcp__github__get_*", "mcp__github__search_*"],
  "ask":   ["mcp__github__create_*"],
  "deny":  ["mcp__github__delete_*"]
}

编程 agent 权限介绍了这些规则存放在哪里,以及为什么 deny 优先于一切。

因模型而异的地方

模型会不会用工具。小型本地模型可能会忽略某个工具,或者传入格式错误的参数;OHarness 会在工具运行前校验参数,并把错误返回给模型,模型通常能自己纠正过来。如果某个模型用某个服务器的工具反复失败,问题在模型,而不在服务器。

常见问题

GPT 或 Gemini 能用 MCP 吗?

能,只要通过一个带 MCP 客户端的 harness。MCP 服务器连接的是 harness,harness 再通过普通的工具调用把它们的工具提供给模型。OHarness 对 OpenAI、Gemini、Anthropic、DeepSeek 以及任意 OpenAI 兼容模型或本地模型都是这样做的。

本地模型支持 MCP 吗?

支持工具调用的本地模型,在带 MCP 客户端的 harness 里运行时就能用 MCP 工具。模型从不直接使用 MCP 协议;是 OHarness 连接服务器并把工具提供给模型。

OHarness 从哪里读取 MCP 服务器配置?

从 ~/.oharness/mcp.json 的 mcpServers 键下读取。从浏览器或桌面应用的连接器菜单添加的服务器也会写到这里。

OHarness 支持哪些 MCP 传输方式?

stdio 和 Streamable HTTP,用的是它自己的 JSON-RPC 客户端,而不是 MCP SDK。需要 OAuth 的远程服务器通过浏览器登录,token 与厂商凭据存放在一起。

相关内容