一个生产就绪的 Model Context Protocol 服务器，封装在星际迷航 LCARS 指挥界面中。
星历：活跃。所有系统正常。
“计算机是人类发明过的最民主的工具。它的目的是执行用户要求的任何事情。”
— 星际舰队指挥部指令
MCPStarfleetCommand 是一个增强型的 Model Context Protocol (MCP) 服务器，具有完全交互式的 LCARS 风格 Web 仪表板 — 这正是星际飞船 企业号 所采用的著名美学。它将 Claude Code AI 集成（通过 MCP stdio）与美观的浏览器命令控制台连接起来，让您可以通过一个统一的界面获得开发工具、文件系统操作、系统监控和 Docker 规模的可观测性。
Related MCP server: Gitea MCP Proxy Agent
┌─────────────────────────────────────────────────────────────────────────────┐
│ ◈ DUAL-INTERFACE DESIGN │
│ │
│ [ Claude Code / AI ] [ Browser ] │
│ │ stdio MCP │ HTTP :3001 │
│ ▼ ▼ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ ENHANCED MCP SERVER CORE │ │
│ │ ┌──────────────┐ ┌──────────────────────┐ │ │
│ │ │ MCP Engine │ │ Express HTTP API │ │ │
│ │ │ (13 Tools) │◄──►│ REST Endpoints │ │ │
│ │ └──────────────┘ └──────────────────────┘ │ │
│ └─────────────────────────────────────────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ [ AI responds with ] [ LCARS Dashboard UI ] │
│ tool results Interactive terminal │
│ System monitoring │
│ One-click tool execution │
└─────────────────────────────────────────────────────────────────────────────┘功能 | 状态 |
MCP stdio 协议 | ✅ 活跃 |
HTTP REST API | ✅ 活跃 |
LCARS Web 仪表板 | ✅ 在线 |
交互式终端 | ✅ 实时 |
响应式设计 | ✅ 所有屏幕 |
工具 | 描述 |
| 仓库状态 |
| 完整提交历史 |
| 文件级差异 |
| 分支列表 |
| 递归代码搜索 |
工具 | 描述 |
| 目录浏览 |
| 文件内容查看器 |
| 文件写入器 |
| 目录创建 |
| Shell 执行 |
| 实时系统指标 |
工具 | 描述 |
| JSON 验证 |
| JSON 格式化 |
# 1. Install crew
npm install
# 2. Engage engines
npm start # Production warp
npm run dev # Debug mode (verbose logs)
# 3. Open LCARS console
open http://localhost:3001# Launch the full starship
docker-compose up -d
# Services come online:
# http://localhost:3001 ← MCP Server + LCARS Dashboard
# http://localhost:3000 ← Grafana Analytics (change default creds in .env!)
# http://localhost:3002 ← Real-time Analytics Engine
# http://localhost:9090 ← Prometheus Metrics
# http://localhost:8080 ← cAdvisor Container Monitor
# Hail all stations
docker-compose logs -f
# Stand down
docker-compose down📖 完整部署指南 →
DOCKER-README.md· 快速入门 →QUICKSTART.md
┌──────────────────────────┐
│ Internet / NGINX Proxy │
│ Load Balancing · SSL · Rate Limiting │
└────────────┬─────────────┘
│
┌──────────────────────┼──────────────────────┐
│ │ │
┌─────────▼──────────┐ ┌────────▼────────┐ ┌─────────▼──────────┐
│ MCP SERVER │ │ GRAFANA │ │ ANALYTICS │
│ Port 3001 │ │ Port 3000 │ │ Port 3002 │
│ HTTP + MCP/stdio │ │ Dashboards │ │ Metrics / Events │
└─────────┬──────────┘ └────────┬────────┘ └─────────┬──────────┘
│ │ │
┌─────────▼──────────────────────▼──────────────────────▼──────────┐
│ DATA LAYER │
│ Redis (cache) · Prometheus (metrics) · Volumes │
└──────────────────────────────────────────────────────────────────┘服务 | 端口 | 用途 |
MCP 服务器 |
| 核心服务器 · LCARS 仪表板 · REST API |
Grafana |
| 可视化分析 · 警报 · 仪表板 |
分析 |
| 实时事件跟踪 |
Prometheus |
| 时序指标数据库 |
cAdvisor |
| 容器资源监控 |
Redis |
| 缓存层 |
NGINX |
| 反向代理 · SSL |
╔══════════════════════════════════════════════════════════════════╗
║ ████ STARFLEET MCP ████████████████████████████████ 47.2 GHz ████║
╠════════════╦═══════════════════════════════════════════════════╣
║ NAV ║ ┌──────────────────────────────────────────┐ ║
║ ▶ TERMINAL ║ │ > system_info │ ║
║ FILES ║ │ ✔ CPU: 12% MEM: 4.2GB UPTIME: 99.9% │ ║
║ GIT ║ │ > git_status │ ║
║ SYSTEM ║ │ ✔ Branch: main Modified: 2 Clean │ ║
║ TOOLS ║ └──────────────────────────────────────────┘ ║
║ ║ ║
║ ▓▓▓▓▓▓▓▓▓▓ ║ [⚡ GIT STATUS] [📁 LIST FILES] [💻 SYS INFO] ║
╚════════════╩═══════════════════════════════════════════════════╝仪表板功能包括：
⚡ 交互式终端 — 带有颜色编码输出的实时命令执行
📡 系统监控 — 实时 CPU、内存、磁盘和运行时间仪表
🗂️ 工具面板 — 每个 MCP 工具都可作为一键式 LCARS 按钮使用
🔐 文件操作 — 直接在浏览器中读取、写入、浏览文件
📊 Git 集成 — 一目了然的状态、日志、差异、分支
# ─── Status check ───────────────────────────────────────────────
curl http://localhost:3001/api/status
# ── List all 13 available tools ─────────────────────────────────
curl http://localhost:3001/api/tools
# ── Execute any tool ────────────────────────────────────────────
curl -X POST http://localhost:3001/api/tools/execute \
-H "Content-Type: application/json" \
-d '{"tool": "system_info", "args": {}}'
curl -X POST http://localhost:3001/api/tools/execute \
-H "Content-Type: application/json" \
-d '{"tool": "git_status", "args": {"repoPath": "."}}'
curl -X POST http://localhost:3001/api/tools/execute \
-H "Content-Type: application/json" \
-d '{"tool": "search_files", "args": {"query": "TODO", "searchDir": "."}}'MCP 协议 — 服务器通过
stdio使用完整的 MCP 协议。将 Claude Code 指向它，它就会成为您开发环境的扩展。
变量 | 默认值 | 描述 |
|
| HTTP 服务器端口 |
| (未设置) | 设置 |
|
| 环境模式 |
在启动前复制 .env.example → .env 并进行调整。
◈ Input validation on all tool parameters
◈ Path normalization — prevents directory traversal attacks
◈ Command execution sandboxed with 10 MB output buffer
◈ Error messages sanitized before client delivery
◈ NGINX rate limiting in production Docker stack
◈ Non-root container execution in Dockerfile组件 | 技术 |
运行时 | Node.js 18+ |
MCP 协议 |
|
HTTP 服务器 | Express.js 5.x |
仪表板 UI | 原生 HTML · CSS (LCARS) · JS |
分析 | 自定义指标引擎 |
监控 | Prometheus + Grafana |
缓存 | Redis |
代理 | NGINX |
容器 | Docker + Docker Compose |
Linting | ESLint + Prettier |
npm run dev # Engage debug warp (DEBUG=1)
npm run lint # ESLint sweep
npm run lint:fix # Auto-fix lint violations
npm run format # Prettier formatting
npm run format:check # Verify formatting
npm run audit:fix # Fix known vulnerabilities完整操作参考 →
CHEATSHEET.md· 架构深度解析 →ARCHITECTURE.md
╔═══════════════════════════════════════════════════════════╗
║ ◈ STARFLEET MCP · ALL SYSTEMS NOMINAL · WARP READY ◈ ║
╚═══════════════════════════════════════════════════════════╝“勇敢地交付前人未曾交付的代码。”
⭐ 如果此仓库帮助您达到了曲速，请给它加星！
A MCP server built for developers enabling Git based project management with project and personal…
Create, deploy, and operate MCP servers directly from your GitHub repositories.
Your agents' cloud. MCP server with search, execute, packages, jobs, secrets, and integrations.
Self-hosted MCP server: 26 deterministic dev, security, and EVM tools.
