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 status
• git_log - Commit history
• git_diff - File differences
• git_branch - Branch listing
• search_files - Code search

System Operations

• list_files - Directory browsing
• read_file / write_file - File I/O
• create_directory - Directory creation
• run_command - System commands
• system_info - System metrics

Data Processing

• parse_json - JSON validation
• format_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-