MCP Workspace Server

Overview

MCP Workspace Server provides comprehensive workspace management capabilities combining secure file operations, Git version control, and GitHub integration in a single MCP server for complete development workflow automation.

Features

File System Operations

• Read and write files securely
• Directory management
• File search and navigation
• Path validation and sanitization
• Configurable access control

Git Integration

• Repository initialization
• Commit creation and management
• Branch operations
• Merge and rebase
• Conflict resolution assistance
• History exploration
• Diff and log viewing

GitHub Tools

• Repository management
• Pull request operations
• Issue tracking
• Code review
• Actions workflow management
• Release management
• Collaboration features

Workspace Management

• Project organization
• Multi-repository support
• Workspace configuration
• Environment management
• Dependency tracking

Use Cases

• Complete development workflow automation
• Code review and collaboration
• Release management
• Issue tracking and project management
• Documentation management
• CI/CD workflow integration
• Team coordination
• Repository maintenance

Git Operations

Local Repository

• git init, clone, pull, push
• git add, commit, reset
• git branch, checkout, merge
• git log, diff, show
• git stash, clean

Advanced Git

• Interactive rebase
• Cherry-pick
• Bisect for debugging
• Submodule management
• Tag management

GitHub Integration

Repositories

• Create and manage repos
• Fork and clone
• Archive and delete
• Settings and permissions

Pull Requests

• Create PRs
• Review code changes
• Comment and discuss
• Merge strategies
• Auto-merge configuration

Issues

• Create and update issues
• Label management
• Milestone tracking
• Assignment and triage

Actions

• Workflow management
• Run history
• Artifact handling
• Secrets management

Security

• Secure file access controls
• Git credential management
• GitHub token authentication
• Path traversal prevention
• Operation whitelisting

Configuration

{
  "workspace": {
    "root": "/path/to/workspace",
    "allowedPaths": ["/projects", "/repos"]
  },
  "git": {
    "user": "name",
    "email": "[email protected]"
  },
  "github": {
    "token": "ghp_..."
  }
}

Technical Implementation

Built with Node.js, using isomorphic-git for Git operations and Octokit for GitHub API integration. Implements secure file system access with comprehensive validation.

Integration

Compatible with Claude Desktop, Cursor, VS Code, and other MCP clients. Provides unified interface for all workspace operations.