内容
# MCP 服务器部署
适用于**任何 Windows 安装**的**多 MCP 服务器**全自动部署。 使用单个命令部署 Blender、文件系统、GitHub 和任何其他 MCP 服务器。无论是否使用 winget、管理员权限或事先设置，都可以正常工作。
## 一键安装
打开 PowerShell 并运行：
```powershell
Set-ExecutionPolicy Bypass -Scope Process -Force; irm https://raw.githubusercontent.com/codingmachineedge/blender-mcp-deploy/main/bootstrap.ps1 | iex
```
就这样。所有内容都会自动安装和配置。
## 快速开始
```powershell
# 克隆仓库
git clone https://github.com/codingmachineedge/blender-mcp-deploy.git
cd blender-mcp-deploy
# 添加服务器
.\add-server.ps1 -Name "blender" -PipPackage "blender-mcp" -Description "Blender 3D" -RequiresBlender
.\add-server.ps1 -Name "github" -NpxCommand "@modelcontextprotocol/server-github" -Description "GitHub API"
.\add-server.ps1 -Name "filesystem" -NpxCommand "@modelcontextprotocol/server-filesystem" -Description "文件访问"
# 部署所有内容
.\setup.ps1
```
## 管理服务器
```powershell
# 添加基于 Python 的服务器
.\add-server.ps1 -Name "myserver" -PipPackage "my-mcp-server" -Description "我的自定义服务器"
# 添加基于 npm/npx 的服务器
.\add-server.ps1 -Name "github" -NpxCommand "@modelcontextprotocol/server-github" -Description "GitHub API"
# 添加自定义命令服务器
.\add-server.ps1 -Name "custom" -Command "node" -Args "server.js" -Description "自定义服务器"
# 列出已配置的服务器
.\list-servers.ps1
# 删除服务器
.\remove-server.ps1 -Name "myserver"
# 部署所有启用的服务器
.\setup.ps1
```
## 功能
1. **自动提升到管理员权限**（如果需要，提示 UAC）
2. **检测或安装 Blender** - 检查 PATH、注册表、常见位置；回退到直接下载
3. **检测或安装 Python 3.12** - 相同的检测链，直接下载回退
4. **创建 Python 虚拟环境** 并安装所有基于 Python 的 MCP 服务器
5. **自动安装 Blender 插件** 以适用于依赖 Blender 的服务器
6. **设置 WSL 组件**（如果 WSL 可用）
7. **配置所有 AI 代理** - 编写 OpenCode、Claude Code 和 Codex 的 MCP 配置（项目本地和全局）
## 选项
```powershell
.\setup.ps1 -SkipWsl # 跳过 WSL 设置
.\setup.ps1 -SkipBlenderInstall # 跳过 Blender 安装
.\setup.ps1 -SkipPythonInstall # 跳过 Python 安装
.\setup.ps1 -Portable # 本地安装所有内容（无系统范围更改）
```
## 服务器配置（servers.json）
服务器在 `servers.json` 中定义：
```json
{
"servers": [
{
"name": "blender",
"description": "Blender MCP 服务器，用于 3D 场景操作",
"type": "python",
"pip_package": "blender-mcp",
"version": "",
"command": "python",
"args": ["-m", "blender_mcp"],
"env": {},
"requires_blender": true,
"blender_addon_script": "install-addon.py",
"enabled": true
},
{
"name": "github",
"description": "GitHub API 访问",
"type": "node",
"pip_package": "",
"version": "",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {},
"requires_blender": false,
"blender_addon_script": "",
"enabled": true
}
],
"defaults": {
"install_dir": "",
"venv_path": "",
"portable": false
}
}
```
## 安装后
1. 启动您的 AI 代理（**OpenCode** / **Claude** / **Codex**）
2. MCP 工具将自动可用
3. 对于 Blender 服务器，请先打开 Blender
## 手动启动 MCP 服务器
```powershell
.\scripts\start-mcp-server.ps1 # Windows（Blender）
wsl bash scripts/start-mcp-server-wsl.sh # WSL
```
## 编写的代理配置
| 代理 | 项目配置 | 全局配置 |
|----------|--------------------|--------------------------------------------|
| OpenCode | `opencode.json` | `~/.config/opencode/opencode.json` |
| Claude | `.mcp.json` | `~/.claude/claude_desktop_config.json` |
| Codex | `AGENTS.md` | `~/.codex/config.json` |
## 要求
- Windows 10/11
- PowerShell 5.1+（随 Windows 包含）
- 互联网连接（用于首次下载）
- 不需要管理员权限（安装到用户目录）
- 不需要 winget（包含直接下载回退）
## 批处理文件
适用于 cmd.exe 或双击执行：
- `setup.bat` - 运行部署
- `bootstrap.bat` - 从 GitHub 一键安装
- `add-server.bat` - 添加新服务器
- `remove-server.bat` - 删除服务器
- `list-servers.bat` - 列出已配置的服务器
## 故障排除
**"安装后未找到 Blender/Python"** - 重新启动终端并重新运行。PATH 更改需要新会话。
**权限被拒绝** - 使用 `-Portable` 标志将所有内容安装在 `%LOCALAPPDATA%` 下。
**WSL 不可用** - 没关系，WSL 是可选的。Windows MCP 服务器独立工作。
**服务器无法工作** - 运行 `.\list-servers.ps1` 检查是否启用，然后重新运行 `.\setup.ps1`。
