Enhanced MCP Server
A comprehensive Model Context Protocol (MCP) server with a custom-built dashboard UI that provides developer tools, system operations, and data processing capabilities.
Features
🚀 Dual Interface
- MCP Protocol (stdio) for Claude Code integration
- HTTP Dashboard (Web UI) for interactive use
🛠️ Developer Tools
- Git operations (status, log, diff, branches)
- File system management
- Code search and analysis
💻 System Operations
- Command execution (sync/async)
- System monitoring and information
- Process management
📊 Data Processing
- JSON parsing and formatting
- File content manipulation
- Search capabilities
Quick Start
Installation
npm install
Run Server
npm start # Production mode
npm run dev # Development with debug logging
Access Dashboard
Open your browser to: http://localhost:3001
Dashboard Features
- Interactive Terminal - Real-time command execution with output
- System Monitoring - Live system stats and metrics
- Tool Categories - Organized by functionality with one-click execution
- Responsive Design - Works on desktop and mobile devices
Architecture
- MCP Server: Protocol-compliant server for integration with Claude Code
- HTTP Server: Express.js dashboard with RESTful API
- Shared Engine: Common tool execution for both interfaces
- Error Handling: Comprehensive logging and error management
Available Tools
Developer Tools
git_status- Repository statusgit_log- Commit historygit_diff- File differencesgit_branch- Branch listingsearch_files- Code search
System Operations
list_files- Directory browsingread_file/write_file- File I/Ocreate_directory- Directory creationrun_command- System commandssystem_info- System metrics
Data Processing
parse_json- JSON validationformat_json- JSON formatting
API Usage
HTTP REST API
# Get server status
curl http://localhost:3001/api/status
# List available tools
curl http://localhost:3001/api/tools
# Execute a tool
curl -X POST http://localhost:3001/api/tools/execute \
-H "Content-Type: application/json" \
-d '{"tool": "system_info", "args": {}}'
MCP Protocol
The server automatically handles MCP protocol requests via stdio transport.
Configuration
- PORT: HTTP server port (default: 3001)
- DEBUG: Enable debug logging (set DEBUG=1)
Security
- Input validation on all parameters
- Path resolution to prevent directory traversal
- Command execution limits (10MB buffer)
- Error message sanitization
Development
Built with:
- Node.js 18+
- Express.js for HTTP server
- MCP SDK for protocol compliance
- Vanilla HTML/CSS/JS for dashboard
Transform your basic MCP server into something great! 🚀# MCPStarfleetCommand-