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-