增强开发环境与MCP服务器

一个全面的开发环境，包含UV包管理器、Open解释器（开发分支）和模型上下文协议服务器。

🚀 特性

• UV包管理器，实现快速Python包管理
• 现代CLI工具（exa, bat, ripgrep等）
• 带Oh My Zsh及有用插件的Zsh shell
• 开发工具（git, vim, tmux等）
• 基于Rust的性能工具
• Docker和Vagrant配置
• 优化的Python开发环境

🛠️ 包含的工具

Python工具

• UV包管理器
• IPython
• Black（代码格式化工具）
• isort（导入排序工具）
• mypy（类型检查工具）
• ruff（代码检查工具）
• pytest（测试框架）
• debugpy（调试工具）
• pre-commit（预提交钩子）

现代CLI工具

• exa（现代ls替代工具）
• bat（现代cat替代工具）
• ripgrep（现代grep替代工具）
• fd-find（现代find替代工具）
• delta（git diff增强工具）
• zoxide（智能cd工具）
• starship（shell提示工具）
• dust（现代du替代工具）
• hyperfine（基准测试工具）

开发工具

• Git
• Vim
• Tmux
• HTTPx
• Docker
• Docker Compose

🚀 快速开始

使用Docker

# 构建并启动容器
docker-compose up -d

# 进入容器
docker-compose exec dev zsh

# 或使用运行命令
docker-compose run --rm dev

使用Vagrant

# 启动虚拟机
vagrant up

# 通过SSH进入虚拟机
vagrant ssh

# 销毁虚拟机
vagrant destroy

📁 目录结构

.
├── Dockerfile           # 容器定义文件
├── docker-compose.yml   # 容器编排文件
├── Vagrantfile         # 虚拟机定义文件
├── .zshrc              # Shell配置文件
├── workspace/          # 你的项目目录
└── .config/
    └── uv/            # UV配置目录

🔧 使用方法

包管理

# 安装包
python-install pandas numpy

# 创建虚拟环境
venv-create

# 激活虚拟环境
venv-activate

# 安装项目依赖
python-deps

开发工作流

# 初始化新项目
uv-init myproject

# 从模板创建项目
uv-scaffold fastapi myapi

# 设置测试
uv-test-setup

# 检查项目结构
uv-project-check

维护

# 清理UV缓存
uv-clean

# 重建虚拟环境
uv-venv-rebuild

# 检查系统
uv-doctor

⚙️ 自定义配置

添加本地配置

创建~/.zshrc.local用于机器特定设置：

# 本地环境变量
export MY_VAR="value"

# 本地别名
alias myalias="mycommand"

修改UV配置

编辑~/.config/uv/uvconfig.toml：

[cache]
最大容量 = "10GB"
共享 = true

[network]
并发下载数 = 8

🔍 故障排除

常见问题

1. 包安装问题

   uv-clean
   uv-doctor
   

2. 虚拟环境问题

   uv-venv-rebuild
   

3. 性能问题

   bench "your-command"  # 使用hyperfine进行基准测试
   

📦 维护

容器更新

# 无缓存重建容器以获取更新
docker-compose build --no-cache

# 拉取最新基础镜像
docker-compose pull

虚拟机更新

# 更新虚拟机
vagrant provision

# 更新虚拟机镜像
vagrant box update

🔒 安全注意事项

• 容器以非root用户运行
• SSH密钥只读挂载
• Git配置只读挂载
• 使用最小基础镜像
• 定期进行安全更新