Agent Config Bridge

agent-config-bridge

一个 MCP 服务，可在 Claude Code、Codex CLI、Cursor 和 Gemini CLI 之间迁移你的编码 Agent 配置：指令文件（CLAUDE.md、AGENTS.md、.cursor/rules/*.mdc、.cursorrules、GEMINI.md）和 MCP 服务配置（mcpServers JSON ⇄ Codex config.toml ⇄ Gemini settings.json）。

通过 stdio 在本地运行。**不会发起网络请求，也不会收集遥测数据。**只有在调用 migrate_project 并设置 write: true 时，才会写入文件。

更喜欢使用网页 UI？可在浏览器中通过 getaicodingagent.com 使用同一转换器。

工具

工具	功能
convert_rules	将一种工具的指令文本转换为其他工具所需的文件和路径。也可以通过符号链接或 @AGENTS.md 导入，共享同一个 AGENTS.md
convert_mcp_config	MCP 服务：Claude Code / Claude Desktop / Cursor JSON ⇄ Codex [mcp_servers.*] TOML ⇄ Gemini httpUrl/url
detect_agent_configs	以只读方式扫描项目中的所有 Agent 配置文件和技能文件夹，并列出尚未配置的工具
migrate_project	根据现有配置生成缺失的配置。默认仅试运行。除非设置 overwrite: true，否则跳过现有文件；合并 .gemini/settings.json
compat_matrix	列出各工具读取配置的位置，并提供官方文档链接和验证日期。官方文档未说明的内容会返回 unknown

安装

需要 Node.js 18 或更高版本，以及 npm 10 或更高版本（npm 9.2 无法通过 npx 运行 GitHub 软件包）。该软件包未发布到 npm。可直接从 GitHub 运行（仓库已提交 dist/，因此无需构建步骤）：

npx -y github:onehumanbeing/agent-config-bridge

Claude Code

claude mcp add agent-config-bridge -- npx -y github:onehumanbeing/agent-config-bridge

Codex CLI

codex mcp add agent-config-bridge -- npx -y github:onehumanbeing/agent-config-bridge

或者将以下内容添加到 ~/.codex/config.toml：

[mcp_servers.agent-config-bridge]
command = "npx"
args = ["-y", "github:onehumanbeing/agent-config-bridge"]

Cursor：.cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）。Gemini CLI：.gemini/settings.json 或 ~/.gemini/settings.json：

{ "mcpServers": { "agent-config-bridge": { "command": "npx", "args": ["-y", "github:onehumanbeing/agent-config-bridge"] } } }

MCPB 捆绑包：从 v0.1.0 发布页 下载 agent-config-bridge-0.1.0.mcpb，并在兼容 MCPB 的客户端中打开（例如，双击即可安装到 Claude Desktop）。依赖项已打包在内。

从克隆的仓库运行

git clone https://github.com/onehumanbeing/agent-config-bridge && cd agent-config-bridge
claude mcp add agent-config-bridge -- node "$PWD/dist/index.js"

MCP Registry 名称：io.github.onehumanbeing/agent-config-bridge

示例提示词

• “检测此仓库中的 Agent 配置，并将其迁移到 Codex 和 Cursor（先试运行）。”
• “将此 Claude Desktop 配置转换为 Codex TOML。”
• “Gemini CLI 从哪里读取 MCP 配置？使用 compat_matrix。”

链接

• 网页转换器和兼容性表格：https://getaicodingagent.com
• 17 种 Agent 的配置矩阵：https://getaicodingagent.com/config/
• 比较编码 Agent：https://getaicodingagent.com/compare

开发

npm install && npm test   # builds, then runs unit tests plus an MCP client smoke test

MIT © onehumanbeing