C
Codex MCP Migrate
by @fhyxz1
codex-mcp-migrate:灵活可靠的 mcpconfig.json -> config.toml 迁移工具。支持零参数自动探测、增量合并、同名覆盖、备份回滚 与幂等执行,帮助你无缝迁移到 Codex。 codex-mcp-migrate: A flexible, reliable mcpconfig.json -> config.toml migration tool with zero-arg auto-detect, incremental merge, overwrite, backup rollback, and idempotency to help you migrate seamlessly to Codex.
Created 2/9/2026
Updated about 9 hours ago
README
Repository documentation and setup instructions
codex-mcp-migrate
中文 | English
codex-mcp-migrate 是一个灵活、可靠的迁移工具,用于将 mcpconfig.json / mcp-config.json 无缝迁移到 Codex config.toml。
快速开始
方式一:全局安装
npm i -g codex-mcp-migrate
codex-mcp-migrate --dry-run
codex-mcp-migrate
方式二:npx 运行
npx codex-mcp-migrate --dry-run
npx codex-mcp-migrate
迁移流程
- 准备源配置文件:
mcpconfig.json或mcp-config.json。 - 在同目录放置目标
config.toml(或用--toml指定路径)。 - 先执行
--dry-run预览新增/更新/未变更结果。 - 再执行正式命令完成迁移。
- 如需回滚,可使用
~/.codex/backups下的备份文件。
自动探测规则
未传 --json / --toml 时:
- JSON:按顺序探测
./mcp-config.json、./mcpconfig.json - TOML:优先
./config.toml,否则回退~/.codex/config.toml
CLI 参数
--json <path>输入 JSON 文件--toml <path>目标 TOML 文件--dry-run仅预览,不写入--backup写入前备份(默认)--no-backup关闭备份--backup-dir <path>备份目录(默认~/.codex/backups)--verbose详细日志
退出码
0成功1运行时/IO/解析错误2schema 校验错误3写入失败
Quick Setup
Installation guide for this server
Install Package (if required)
npx @modelcontextprotocol/server-codex-mcp-migrate
Cursor configuration (mcp.json)
{
"mcpServers": {
"fhyxz1-codex-mcp-migrate": {
"command": "npx",
"args": [
"fhyxz1-codex-mcp-migrate"
]
}
}
}
Author Servers
Other servers by fhyxz1