SuperAPI AI 工具集

mcp-convert

智能体与模型

查看项目

更新于 10-15 16:51

技能介绍

用途:把 Claude Code 的 MCP 服务器定义迁移到 Codex CLI。转换器读取 ~/.claude.json 顶层的 mcpServers 块,生成 Codex 可用的 MCP 配置,环境变量值以明文直接复制。

主要能力:预览可迁移的服务器;按名称选择部分服务器;支持 dry-run、apply、export-toml 三种模式;--overwrite 可覆盖 Codex 中同名条目;执行后用 codex mcp list 验证。

使用方式:脚本位于 scripts/convert_claude_to_codex.py。预览:python3 skills/mcp-convert/scripts/convert_claude_to_codex.py --mode dry-run;应用:python3 skills/mcp-convert/scripts/convert_claude_to_codex.py --mode apply --overwrite;仅导出 TOML:python3 skills/mcp-convert/scripts/convert_claude_to_codex.py --mode export-toml。可用 --server <name> 只转换指定服务器。

交互流程:先确认 ~/.claude.json 存在并预览服务器;若存在多个服务器且用户未指定,用 AskUserQuestion 询问迁移范围(推荐全部迁移,也可仅含密钥的或手动选择子集);再询问执行模式(推荐 dry-run、立即应用或仅导出 TOML);已明确回答的问题不重复询问。

限制:仅针对 ~/.claude.json 顶层 mcpServers,项目级 MCP 覆盖需另行检查;环境变量以明文写入 Codex 配置;遇到不支持的服务器类型会明确报告并跳过,不做猜测。语言上自动匹配用户语言,偏好简洁的操作指引。