VertexStudio/developer

A general purpose Model Context Protocol (MCP) server that provides comprehensive developer tools for file editing, shell command execution, and screen capture capabilities. Built using the rmcp crate.
🚀 Features
📝 Text Editor
- **View files** with language detection for markdown formatting
- **Write/create files** with automatic directory creation
- **String replacement** with precise matching
- **Undo functionality** with edit history
- **File size protection** (400KB limit for text files)
🖥️ Shell Integration
- **Cross-platform command execution** (PowerShell on Windows, bash/zsh on Unix)
- **Combined stdout/stderr output** as it appears in terminal
- **Output size protection** (400KB limit)
- **Platform-specific optimizations**
📸 Screen Capture
- **Full display screenshots** with monitor selection
- **Window-specific capture** by title
- **Automatic image optimization** (768px max width)
- **Base64 encoded PNG output**
🖼️ Image Processing
- **Image file processing** from disk
- **Automatic resizing** while maintaining aspect ratio
- **Format conversion** to PNG
- **macOS screenshot filename handling**
🔄 Workflow Management
- **Multi-step problem solving** with sequential progression
- **Branching workflows** for alternative solution paths
- **Step revision** capability to update previous steps
- **Context preservation** across complex reasoning processes
🔒 Security Features
- **Gitignore integration** - respects .gitignore patterns for file access control
- **Path validation** - requires absolute paths to prevent directory traversal
- **File size limits** - prevents memory exhaustion attacks
- **Access pattern filtering** - blocks access to sensitive files
📋 Requirements
- **Rust** 1.70+ (for building from source)
- **Claude Desktop** or compatible MCP client
- **Operating System**: macOS, Linux, or Windows
🛠️ Installation
Option 1: Build from Source (Recommended)
1. **Clone the repository:**
2. **Build the project:**
3. **The binary will be available at:**
Option 2: Development Build
For development/testing purposes:
⚙️ Configuration
Claude Desktop Setup
1. **Open Claude Desktop configuration file:**
**macOS/Linux:**
**Windows:**
2. **Add the developer server configuration:**
**Example configurations:**
**Development build:**
**Production build:**
3. **Restart Claude Desktop** to load the new configuration.
File Access Control (Optional)
Create a .gitignore file in your working directory to control which files the server can access:
The server will automatically respect these patterns and block access to matching files.
🎯 Usage Examples
Once configured, you can use these tools directly in Claude Desktop:
Text Editing
Shell Commands
Screen Capture
Image Processing
Workflow Management
🏗️ Architecture
🔧 Tool Reference
text_editor
- **Commands:** view, write, str_replace, undo_edit
- **Parameters:** path (required), file_text, old_str, new_str
- **Limits:** 400KB file size, absolute paths only
shell
- **Parameters:** command (required)
- **Features:** Platform detection, output redirection, size limits
- **Limits:** 400KB output size