A production-grade Model Context Protocol (MCP) server for SVN operations, designed to handle 1 million+ requests with OAuth authentication and scalable architecture.
概览
A production-grade Model Context Protocol (MCP) server for SVN operations, designed to handle 1 million+ requests with OAuth authentication and scalable architecture. - support - : stdio and http-sse - for secure SVN access - for horizontal scalability - approach with input validation and sanitization - with async I/O and resource limits - Python 3.11+ (installed at C:\Program Files\Python311) - SVN command-line tools - SVN repository access with OAuth token 1. Clone or download this project 2. Install dependencies: 4. Configure your SVN credentials in .
README
以下为原文 README 节选,完整内容请查看原文。
SVN MCP Server
A production-grade Model Context Protocol (MCP) server for SVN operations, designed to handle 1 million+ requests with OAuth authentication and scalable architecture.
Features
- MCP Protocol 2025-06-18 support
- Dual Transport Modes: stdio and http-sse
- OAuth Authentication for secure SVN access
- Stateless Design for horizontal scalability
- Security-First approach with input validation and sanitization
- Performance Optimized with async I/O and resource limits
SVN Operations
| Tool | Description |
|---|---|
svn_authenticate |
Validate SVN credentials using OAuth |
svn_info |
Get repository information |
svn_commit |
Commit changes to repository |
svn_diff |
Show differences between revisions |
svn_history |
Show commit history |
svn_last_commit |
Show latest commit details |
svn_status |
Show working copy status |
svn_checkout |
Checkout repository to local path |
svn_update |
Update working copy |
svn_add |
Add files to version control |
svn_delete |
Delete files from version control |
svn_log |
Show detailed commit log with file changes |
Quick Start
Prerequisites
- Python 3.11+ (installed at
C:\Program Files\Python311) - SVN command-line tools
- SVN repository access with OAuth token
Installation
-
Clone or download this project
-
Install dependencies:
pip install -r requirements.txt -
Create environment file:
copy .env.example .env -
Configure your SVN credentials in
.env:SVN_URL=https://your-svn-server.com/svn/repository SVN_USERNAME=your_username OAUTH_TOKEN=your_oauth_token
Running the Server
stdio mode (default):
python main.py
# or explicitly:
python main.py --transport stdio
HTTP-SSE mode:
python main.py --transport sse --host localhost --port 8082
Command line options:
python main.py --help
# Options:
# --transport {stdio,sse} Transport mode (default: stdio)
# --host HOST Host for SSE mode (default: localhost)
# --port PORT Port for SSE mode (default: 8082)
# --version Show version and exit
SSE Mode Endpoints:
http://localhost:8082/- Server informationhttp://localhost:8082/sse- SSE stream for MCP communicationhttp://localhost:8082/tools- Available tools listhttp://localhost:8082/health- Health check endpoint
Development Setup
For development with proper package structure:
# Install in development mode
pip install -e .
# Install with development dependencies
pip install -e ".[dev]"
# Run tests
python -m pytest tests/
# Run with coverage
python -m pytest tests/ --cov=src/svn_mcp --cov-report=html
Configuration
Environment Variables
| Variable | Description | Default |
|---|---|---|
SVN_URL |
SVN repository URL | None |
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →