MCP Svn

🚀 SVN MCP Server

SVN MCP Serverは、Subversion (SVN) との統合を目的とした完全なMCP (Model Context Protocol) サーバーです。これにより、AIエージェントがSVNリポジトリを効率的に管理できるようになります。

✨ 主な機能

• ✅ リポジトリの基本操作: info, status, log, diff, checkout, update
• ✅ ファイル管理: add, commit, delete, revert
• ✅ メンテナンスツール: cleanup
• 🔄 ブランチ管理: (開発中)
• 🔄 高度な操作: merge, switch, properties (開発中)
• 🔄 分析ツール: blame, conflict detection (開発中)
• 🔄 バッチ操作: (開発中)

📦 インストール

前提条件

• Node.js >= 18.0.0
• Subversion (SVN) がインストールされ、PATHに含まれていること
• TypeScript (開発用)

🔍 SVNのインストールを確認する

SVNがインストールされているか確認する

# SVNを確認する基本コマンド
svn --version

# 実行ファイルの完全パスを確認する
where svn        # Windows
which svn        # Linux/Mac

# 完全なSVNクライアントを確認する
svn --version --verbose

SVNが正しくインストールされている場合の期待される出力:

svn, version 1.14.x (r1876290)
   compiled Apr 13 2023, 17:22:07 on x86_64-pc-mingw32

Copyright (C) 2023 The Apache Software Foundation.
This software consists of contributions made by many people;
see the NOTICE file for more information.
Subversion is open source software, see http://subversion.apache.org/

❌ SVNがインストールされていない場合の一般的なエラー:

# Windows
'svn' is not recognized as an internal or external command

# Linux/Mac  
svn: command not found
bash: svn: command not found

🛠️ 高度な診断

# システムのPATHを確認する
echo $PATH                    # Linux/Mac
echo %PATH%                   # Windows CMD
$env:PATH                     # Windows PowerShell

# システム内のSVN実行ファイルを検索する
find / -name "svn" 2>/dev/null           # Linux
Get-ChildItem -Path C:\ -Name "svn.exe" -Recurse -ErrorAction SilentlyContinue  # Windows PowerShell

# クライアントの特定のバージョンを確認する
svn --version | head -1       # バージョンが記載された最初の行のみを取得する

💾 WindowsでSVNをインストールする

オプション1: パッケージマネージャー

# Chocolateyを使用する (推奨)
choco install subversion

# wingetを使用する
winget install CollabNet.Subversion

# Scoopを使用する
scoop install subversion

オプション2: 公式インストーラー

1. TortoiseSVN (コマンドラインクライアントを含む):

   https://tortoisesvn.net/downloads.html
   ✅ GUIクライアントとCLIを含む
   ✅ Windows Explorerとの統合
   

2. SlikSVN (コマンドラインのみ):

   https://sliksvn.com/download/
   ✅ 軽量 (CLIのみ)
   ✅ 自動化に最適
   

3. CollabNet Subversion:

   https://www.collab.net/downloads/subversion
   ✅ エンタープライズ版
   ✅ 商用サポートが利用可能
   

オプション3: Visual StudioまたはGit for Windows

# Git for Windowsがインストールされている場合、SVNが含まれている可能性がある
git svn --version

# Visual StudioにもSVNが含まれている可能性がある
# 手順: Visual Studio Installer > Modify > Individual Components > Subversion

🐧 LinuxでSVNをインストールする

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install subversion

# CentOS/RHEL/Fedora
sudo yum install subversion        # CentOS 7
sudo dnf install subversion        # CentOS 8/Fedora

# Arch Linux
sudo pacman -S subversion

# Alpine Linux
sudo apk add subversion

🍎 macOSでSVNをインストールする

# Homebrewを使用する (推奨)
brew install subversion

# MacPortsを使用する
sudo port install subversion

# Xcodeコマンドラインツールから (含まれている場合がある)
xcode-select --install

🔧 インストール後のSVNの設定

グローバル設定を確認する

# 現在の設定を表示する
svn config --list

# グローバルユーザーを設定する
svn config --global auth:username tu_usuario

# デフォルトのエディターを設定する
svn config --global editor "code --wait"     # VS Code
svn config --global editor "notepad"         # Windows Notepad
svn config --global editor "nano"            # Linux/Mac nano

リポジトリへのアクセスを確認する

# リポジトリへの接続をテストする (checkoutせずに)
svn list https://svn.ejemplo.com/repo/trunk

# 特定の資格情報でテストする
svn list https://svn.ejemplo.com/repo/trunk --username usuario --password contraseña

NPMからのインストール

npm install -g @grec0/mcp-svn

ローカル開発用のインストール

git clone https://github.com/gcorroto/mcp-svn.git
cd mcp-svn
npm install
npm run build

⚙️ 設定

環境変数

MCP設定の例

{
  "mcpServers": {
    "svn": {
      "command": "npx",
      "args": ["@grec0/mcp-svn"],
      "env": {
        "SVN_PATH": "svn",
        "SVN_WORKING_DIRECTORY": "/path/to/working/copy",
        "SVN_USERNAME": "tu_usuario",
        "SVN_PASSWORD": "tu_contraseña"
      }
    }
  }
}

💻 使用例

システムの状態を確認する

// SVNが利用可能で、作業コピーが有効であることを確認する
const healthCheck = await svn_health_check();

リポジトリの情報を取得する

// 作業コピーの一般的な情報
const info = await svn_info();

// 特定のファイルの情報
const fileInfo = await svn_info("src/main.js");

ファイルの状態を確認する

// すべてのファイルの状態
const status = await svn_status();

// リモート情報を含む状態
const fullStatus = await svn_status(null, true);

リポジトリをチェックアウトする

const checkout = await svn_checkout(
  "https://svn.example.com/repo/trunk",
  "local-copy",
  "HEAD",
  "infinity",
  false,
  false
);

変更をコミットする

// ファイルを追加する
await svn_add(["src/new-file.js", "docs/readme.md"], { parents: true });

// コミットする
await svn_commit(
  "Add new feature and documentation",
  ["src/new-file.js", "docs/readme.md"]
);

🧪 テスト

# テストを実行する
npm test

# カバレッジ付きでテストする
npm run test -- --coverage

# ウォッチモードでテストする
npm run test -- --watch

🏗️ 開発

利用可能なスクリプト

# TypeScriptをコンパイルする
npm run build

# 開発モード
npm run dev

# ウォッチモード
npm run watch

# MCPインスペクター
npm run inspector

# テスト
npm test

# 新しいバージョンを公開する
npm run release:patch
npm run release:minor
npm run release:major

プロジェクトの構造

svn-mcp/
├── package.json
├── tsconfig.json
├── jest.config.js
├── index.ts
├── common/
│   ├── types.ts      # TypeScriptの型定義
│   ├── utils.ts      # SVN用のユーティリティ
│   └── version.ts    # パッケージのバージョン
├── tools/
│   └── svn-service.ts # 主要なSVNサービス
├── tests/
│   └── integration.test.ts # 統合テスト
└── README.md

📊 開発状況

完全な実装チェックリストについては、SVN_MCP_IMPLEMENTATION.md を参照してください。

現在の進捗: 第1段階完了 (基本操作) ✅

次の段階:

• ブランチ管理 (branching)
• 高度な操作 (merge, switch)
• 分析ツール
• バッチ操作

🐛 トラブルシューティング

SVNが見つからない

Error: SVN is not available in the system PATH

解決策: SVNをインストールし、システムのPATHに含まれていることを確認してください。

作業コピーではない

Error: Failed to get SVN info: svn: warning: W155007: '.' is not a working copy

解決策: SVNの作業コピーであるディレクトリに移動するか、最初にチェックアウトしてください。

認証に問題がある

Error: svn: E170001: Authentication failed

解決策: 環境変数 SVN_USERNAME と SVN_PASSWORD を設定してください。

長時間の操作でタイムアウトする

Error: Command timeout after 30000ms

解決策: SVN_TIMEOUT の値を増やしてください。

📄 ライセンス

MITライセンス - 詳細については LICENSE を参照してください。

🤝 コントリビュート

1. プロジェクトをフォークする
2. 新しい機能ブランチを作成する (git checkout -b feature/nueva-caracteristica)
3. 変更をコミットする (git commit -am 'Add nueva caracteristica')
4. ブランチにプッシュする (git push origin feature/nueva-caracteristica)
5. プルリクエストを作成する

📞 サポート

• 問題報告: GitHub Issues
• ドキュメント: プロジェクトのWiki
• メール: soporte@grec0.dev