用于Codex CLI的UV MCP服务器引导
此存储库安装了一个即用型 UV MCP服务器 在Codex CLI设置中。\ 它住在 ~/.uv_mcp/uv-mcp-server 并将其配置块附加到\ ~/.codex/.config.toml 以便Codex可以立即使用它。
______________________________________________________________________
🚀 快速启动
选项A–克隆并运行
git clone https://github.com//uv-mcp-bootstrap.git
cd uv-mcp-bootstrap
chmod +x setup.sh
./setup.sh选项B——安装一个衬里
curl -fsSL https://raw.githubusercontent.com//uv-mcp-bootstrap/main/setup.sh \
| REPO_URL=https://github.com//uv-mcp-bootstrap bash您可以为自己使用此别名： ``bash alias uvsetup='curl -fsSL https://raw.githubusercontent.com//uv-mcp-bootstrap/main/setup.sh | \ REPO_URL=https://github.com//uv-mcp-bootstrap bash'`然后运行uvsetup` 在任何新机器上。
______________________________________________________________________
🧩 脚本的作用是什么
- 将此仓库克隆或更新为
~/.uv_mcp/uv-mcp-server - 跑动
uv init，添加了mcp依赖性，以及uv sync环境是什么 - 在以下位置创建Codex配置的备份
~/.codex/.config.toml..bak
- 附加此MCP服务器块（带
~路径）到您的Codex配置：
# --- BEGIN uv_env_manager (uv-mcp) ---
[mcp_servers.uv_env_manager]
command = "~/.uv_mcp/uv-mcp-server/.venv/bin/python"
args = ["~/.uv_mcp/uv-mcp-server/server.py"]
[mcp_servers.uv_env_manager.env]
UV_NO_MANAGED_PYTHON = "1"
UV_NO_PYTHON_DOWNLOADS = "1"
UV_OFFLINE = "1"
# --- END uv_env_manager (uv-mcp) ---如果食品法典委员会不扩大 ~，用你的绝对回家路取而代之。______________________________________________________________________
⚙️ 环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
OFFLINE | 1 | 1 =仅使用缓存； 0 =允许下载 |
FORCE | 0 | 覆盖现有的MCP块（如果存在） |
MCP_NAME | uv_env_manager | MCP服务器块的名称 |
INSTALL_DIR | ~/.uv_mcp/uv-mcp-server | 安装位置 |
CONFIG_FILE | ~/.codex/.config.toml | Codex配置文件路径 |
______________________________________________________________________
🧪 验证
运行后 setup.sh，重新启动Codex CLI并列出服务器：
您应该看到：
prepare_projectscan_imports_toolensure_depsrun_and_heal_toolenv_summary
然后尝试：
codex tool uv_env_manager.env_summary '{"repo_path":"/tmp"}'______________________________________________________________________
🧼 卸载
rm -rf ~/.uv_mcp/uv-mcp-server
sed -i.bak '/^# --- BEGIN uv_env_manager (uv-mcp) ---$/,/^# --- END uv_env_manager (uv-mcp) ---$/d' ~/.codex/.config.toml______________________________________________________________________
💡 故障排除
uv未找到 → 安装 星光紫外线- Codex未能启动 → 替换
~与您的完整回家之路 - 缓存中没有轮子 → 重新运行
OFFLINE=0在线获取
享受即时、缓存、依赖自动修复的Python环境⚡