让 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 与厂商凭据存放在一起。