AI导哈

UV MCP服务器引导工具

UV MCP服务器引导工具用于在Codex CLI中快速安装和配置UV MCP服务器，提供依赖管理和环境自动修复功能。

  • by Infatoshi
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Infatoshi/uv-mcp-bootstrap

使用说明

用于Codex CLI的UV MCP服务器引导

此存储库安装了一个即用型 UV MCP服务器 在Codex CLI设置中。
它住在 ~/.uv_mcp/uv-mcp-server 并将其配置块附加到
~/.codex/.config.toml 以便Codex可以立即使用它。

🚀 快速启动

选项A–克隆并运行

git clone https://github.com/<your-org>/uv-mcp-bootstrap.git
cd uv-mcp-bootstrap
chmod +x setup.sh
./setup.sh

选项B——安装一个衬里

curl -fsSL https://raw.githubusercontent.com/<your-org>/uv-mcp-bootstrap/main/setup.sh \
| REPO_URL=https://github.com/<your-org>/uv-mcp-bootstrap bash

您可以为自己使用此别名：

alias uvsetup='curl -fsSL https://raw.githubusercontent.com/<your-org>/uv-mcp-bootstrap/main/setup.sh | \
  REPO_URL=https://github.com/<your-org>/uv-mcp-bootstrap bash'

然后运行 uvsetup 在任何新机器上。

🧩 脚本的作用是什么

  1. 将此仓库克隆或更新为 ~/.uv_mcp/uv-mcp-server
  2. 跑动 uv init，添加了 mcp 依赖性，以及 uv sync环境是什么
  3. 在以下位置创建Codex配置的备份 ~/.codex/.config.toml.<date>.bak
  4. 附加此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_project
  • scan_imports_tool
  • ensure_deps
  • run_and_heal_tool
  • env_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环境⚡

相关 MCP