MCP 配置生成器 — claude_desktop_config.json、Cursor、Kiro 一键生成

勾选任意已验证远程 MCP 服务端,立即生成 Claude Desktop / Cursor / VS Code / Windsurf / Kiro / Codex / Cline / Gemini 等 10 大客户端的可粘贴配置文件——含 mcp-remote 桥接方案与原生直连方案。

Select a server above (or choose Custom endpoint) to generate configs for all 6 clients.

🔀 `npx mcp-remote` 替代方案:原生 Streamable HTTP 直连迁移指南

mcp-remote 是为只支持 stdio 的客户端桥接远程 MCP 的临时方案。如今主流客户端已原生支持 Streamable HTTP 直连——去掉桥接可以减少一层进程、避免 Node 运行时依赖,并直接使用服务端 OAuth 2.1 授权流。下表列出了当前各客户端的接入方式:

客户端是否需要 mcp-remote推荐接入方式
Claude Code❌ 不需要(原生)claude mcp add --transport http 直连
Cursor❌ 不需要(原生)mcp.json 中直接写 url,或一键 deeplink 安装
VS Code❌ 不需要(原生).vscode/mcp.json type: "http" + url
ChatGPT❌ 不需要(原生)Developer Mode → Custom Connector 直接填 URL
Windsurf❌ 不需要(原生)mcp_config.json 中 serverUrl 直连
Kiro❌ 不需要(原生).kiro/settings/mcp.json url 直连
Claude Desktop✅ 需要桥接stdio-only:npx -y mcp-remote 仍是官方推荐
Codex CLI❌ 不需要(原生)~/.codex/config.toml [mcp_servers.*] url
Cline❌ 不需要(原生)cline_mcp_settings.json type: "streamableHttp"
Gemini CLI❌ 不需要(原生)~/.gemini/settings.json httpUrl

结论:除非你使用 Claude Desktop 等仅 stdio 的客户端,否则现在就应该迁移到原生 Streamable HTTP 直连——少一层 Node 桥接、更快的握手、直接的 OAuth 授权,还能免除 mcp-remote 版本漂移带来的诡异问题。

❓ 常见问题

mcp-remote 是官方包吗?

是。npx -y mcp-remote 由 Model Context Protocol 官方维护,用途是把只支持 stdio 的客户端桥接到远程 HTTP 端点。它是过渡方案而非长期依赖。

迁移到直连需要改什么?

把配置从 { command: "npx", args: ["-y","mcp-remote",""] } 换成客户端原生字段(Cursor/VS Code/Kiro 为 url,Gemini 为 httpUrl,Codex 为 TOML url),OAuth 端点会直接走浏览器授权而不再经本地中转。

桥接模式什么时候仍然必要?

仅当你的客户端只认 stdio(如 Claude Desktop 当前形态)、或需要在本地对请求做自定义拦截/缓存时,mcp-remote 才是正确选择。

生成器会记录我的 API Key 吗?

不会。整个生成器在浏览器本地执行,所有配置文本只在你的设备上生成与复制。