MCP TortoiseSVN

一个功能完整的 Model Context Protocol (MCP) 服务器，为 Windows 环境提供 TortoiseSVN 和 Subversion 集成支持。

功能特性

• 67+ 个工具：30个命令行 SVN 工具 + 37个 TortoiseSVN GUI 工具
• 完整的 SVN 支持：覆盖日常开发所需的所有 Subversion 操作
• 双重操作模式：
  • 命令行模式 (svn_*)：静默执行，适合自动化脚本
  • GUI 模式 (tortoise_*)：可视化对话框，适合交互式操作
• 类型安全：使用 Zod 进行严格的 TypeScript 类型校验
• Windows 原生支持：完美处理 Windows 路径和 TortoiseSVN 集成

系统要求

• Windows 操作系统
• Node.js 18.0.0 或更高版本
• TortoiseSVN 已安装（提供 svn.exe 和 TortoiseProc.exe）

快速开始

1. 构建项目

# 克隆仓库后进入目录
cd mcp-tortoisesvn

# 安装依赖并构建
npm install

2. 配置 MCP 客户端

Claude Desktop / Cline / 通用 MCP 配置

编辑配置文件：

• Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json
• Cline: VS Code Cline 插件设置中的 MCP 配置

添加以下配置（将路径修改为你的实际路径）：

{
  "mcpServers": {
    "tortoisesvn": {
      "command": "node",
      "args": ["C:\\Users\\YourName\\Codes\\mcp-tortoisesvn\\dist\\index.js"]
    }
  }
}

OpenCode 配置

在 ~/.config/opencode/config.json 中添加：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tortoisesvn": {
      "type": "local",
      "command": [
        "node",
        "C:/Users/YourName/Codes/mcp-tortoisesvn/dist/index.js"
      ],
      "enabled": true,
      "timeout": 30000
    }
  }
}

3. 使用示例

配置完成后，直接在对话中使用自然语言调用：

检查当前目录的 SVN 状态
提交更改，消息为"修复登录bug"
查看最近10条提交历史
创建新分支 feature/login-page

工具分类

SVN 命令行工具 (30个)

用于静默执行，无需用户交互：

| 类别 | 工具 | | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | | 基础操作 | svn_checkout, svn_update, svn_commit, svn_add, svn_delete, svn_revert, svn_cleanup | | 信息查询 | svn_status, svn_log, svn_info, svn_diff, svn_blame | | 分支合并 | svn_copy, svn_move, svn_merge, svn_switch | | 锁定管理 | svn_lock, svn_unlock | | 属性管理 | svn_propset, svn_propget, svn_proplist, svn_propdel | | 高级功能 | svn_export, svn_import, svn_relocate, svn_changelist_add, svn_changelist_remove, svn_resolve, svn_create_patch, svn_apply_patch |

TortoiseSVN GUI 工具 (37个)

用于打开 TortoiseSVN 对话框进行可视化操作：

| 类别 | 工具 | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 仓库操作 | tortoise_checkout, tortoise_import, tortoise_export, tortoise_repocreate, tortoise_repobrowser, tortoise_repostatus, tortoise_revisiongraph | | 基础操作 | tortoise_update, tortoise_commit, tortoise_add, tortoise_revert, tortoise_cleanup, tortoise_resolve, tortoise_remove, tortoise_rename, tortoise_ignore | | 分支合并 | tortoise_copy, tortoise_switch, tortoise_merge, tortoise_mergeall, tortoise_relocate | | 比较查看 | tortoise_diff, tortoise_showcompare, tortoise_blame, tortoise_cat | | 日志历史 | tortoise_log, tortoise_createpatch | | 属性设置 | tortoise_properties, tortoise_settings, tortoise_sync, tortoise_conflict_editor | | 锁定管理 | tortoise_lock, tortoise_unlock | | 工具 | tortoise_about, tortoise_help, tortoise_rebuildiconcache, tortoise_dropvendor |

注意：GUI 工具需要 Windows 桌面环境，会弹出 TortoiseSVN 对话框。

开发

# 开发模式（自动重新编译）
npm run dev

# 构建项目
npm run build

# 类型检查
npm run typecheck

# 代码检查
npm run lint

# 自动修复代码风格
npm run lint:fix

# 格式化代码
npm run format

项目结构

src/
├── tools/
│   ├── svn/               # 30个命令行 SVN 工具
│   │   ├── svn-add.ts
│   │   ├── svn-commit.ts
│   │   └── ...
│   └── tortoise/          # 37个 TortoiseSVN GUI 工具
│       ├── tortoise-about.ts
│       ├── tortoise-commit.ts
│       └── ...
├── types/                 # TypeScript 类型定义
├── utils/                 # 工具函数
├── errors/                # 错误类
└── server.ts              # MCP 服务器主文件

故障排除

问题：命令未找到

解决：确保 TortoiseSVN 已安装并且 TortoiseProc.exe 在系统 PATH 中。

问题：GUI 工具不显示对话框

解决：GUI 工具需要 Windows 桌面环境。在 WSL 或纯命令行环境中无法使用 GUI 工具。

问题：路径错误

解决：确保 MCP 配置中的路径使用双反斜杠（\\）或正斜杠（/）。

技术栈

• TypeScript 5.7 - 类型安全的开发体验
• MCP SDK - Model Context Protocol 官方 SDK
• Zod - 运行时类型验证
• ESLint + Prettier - 代码质量和格式化

许可证

MIT License

---

注意：本项目需要 Windows 操作系统和 TortoiseSVN 客户端。对于 Linux/macOS 用户，建议使用标准 SVN 命令行工具。