用途：在 OpenAI Codex 上安装与管理 ToolUniverse 插件，该插件通过 MCP 服务器暴露 1000+ 科学工具和 130+ 研究技能，全部自动配置。适用于药物发现、变异解读、药物警戒、系统发育、统计建模等研究问题，用自然语言提问即可自动激活技能并调用工具。
前置检查：需要 uv（提供 uvx）和 OpenAI Codex CLI。确认命令：uv --version、codex --version。若 uv 缺失，安装命令为 curl -LsSf https://astral.sh/uv/install.sh | sh。
安装：先注册市场 codex plugin marketplace add mims-harvard/ToolUniverse，再安装 codex plugin add tooluniverse -m tooluniverse，然后重启 Codex。MCP 服务器首次使用时经 uvx tooluniverse 自动启动，冷启动约 30 秒。市场必须用 owner/repo 简写（mims-harvard/ToolUniverse），不要指向插件子目录或原始 URL。
验证与使用：运行 codex plugin list（应显示 tooluniverse 已启用）或 codex plugin list --json 查看版本。之后在 Codex 中直接提问，如“乳腺癌中突变最多的基因是什么？”或“研究二甲双胍”，技能会自动激活，工具通过 find_tools → execute_tool 发现并运行，无需命令前缀。与 Claude Code 插件不同，此 Codex 插件只含 MCP 工具与技能，没有斜杠命令。
API 密钥：多数工具无需密钥；如需更高频率限制或访问受限数据库，可在启动 Codex 的 shell 中导出 NCBI_API_KEY、ONCOKB_API_TOKEN、SEMANTIC_SCHOLAR_API_KEY 等，MCP 服务器会继承。完整密钥列表见 setup-tooluniverse 技能中的 API_KEYS_REFERENCE.md。
更新：Codex 默认在启动时自动升级 Git 市场，无需手动操作；可用 codex plugin marketplace upgrade（可加 tooluniverse）按需刷新。若工具陈旧，运行 uv cache clean tooluniverse 后重启。
固定版本：编辑已安装插件的 .mcp.json，将参数设为 "args": ["tooluniverse@1.3.0"]（版本号可替换为 PyPI 上的发行版），重启 Codex。
卸载：codex plugin remove tooluniverse 与 codex plugin marketplace remove tooluniverse。
替代安装（本地检出/隔离环境）：git clone https://github.com/mims-harvard/ToolUniverse.git，codex plugin marketplace add ./ToolUniverse，codex plugin add tooluniverse -m tooluniverse。本地路径市场不会自动升级。
限制：需 Python >= 3.10；若 uvx 命令未找到或服务器无法启动，属于 uv/Python 问题而非 Codex；全局 uv 工具可能遮蔽 uvx。更多故障排查见 GitHub issues。本文档未提供收费与价格信息。