量子 MCP 管理器

Name: 量子 MCP 管理器
Author: Parthmonga

作者：Parthmonga5 星标更新：2025-08-08

安装使用来源：spider==github.com

项目介绍

Amazon Q - MCP管理仪表盘

</div>

一个现代化、响应式的基于web的仪表盘，用于在macOS上管理Amazon Q MCP（模型上下文协议）服务器。此仪表盘允许您轻松查看、启用和禁用配置在您的~/.aws/amazonq/mcp.json文件中的MCP服务器。

功能

🎛️ 仪表盘概览：一目了然地查看所有已配置的MCP服务器
🟢 状态指示器：绿色/红色灯光显示启用/禁用状态
⚡ 快速操作：启用/禁用单个服务器或一次性启用/禁用所有服务器
📊 统计数据：实时统计显示总服务器数、启用服务器数和禁用服务器数
🔄 自动同步：自动读取和写入您的MCP配置文件
📱 响应式设计：完美适用于桌面、平板和移动设备
🎨 现代用户界面：干净直观的界面，带有平滑动画
🔒 安全操作：在进行更改之前创建备份
⌨️ 键盘快捷键：通过键盘快捷键快速访问

屏幕截图

轻模式

干净现代的界面，采用玻璃形态设计和直观的控制：

轻模式仪表盘

深模式

简洁的深色主题，增强视觉对比度和现代美学：

深模式仪表盘

仪表盘浏览

根据上述屏幕截图，您将在仪表盘中找到以下内容：

🎛️ 头部与控制

仪表盘标题："MCP管理仪表盘"，采用优雅字体
主题切换：右上角的太阳/月亮图标，用于在轻模式和深模式之间切换
刷新按钮：从您的MCP文件重新加载服务器配置
服务器统计：实时计数显示“总计：4，启用：2，禁用：2”

📊 服务器管理网格

每个服务器都以单独的卡片形式显示，包含：

服务器名称：清晰标记（例如，“filesystem”，“brave-search”，“mcp-server-git”，“postgres”）
服务器类型徽章：视觉指示器显示类型（Docker，Python，Node.js等）
状态指示器：绿色点（启用）或红色点（禁用），带有脉动动画
命令预览：显示实际执行的命令
启用/禁用切换：单独的按钮来控制每个服务器
服务器详情：环境变量、参数和配置信息

⚡ 批量操作面板

“全部启用”按钮：一键激活所有MCP服务器
“全部禁用”按钮：同时禁用所有服务器
操作反馈：吐司通知确认成功操作

📈 实时活动时间线

活动日志：显示带有时间戳的最近操作
操作类型：服务器启用/禁用，配置刷新等
时间戳：每次操作的确切时间（例如，“下午3:28:45”）
操作成功：完成操作的视觉确认

🎨 视觉设计元素

玻璃形态卡片：具有背景模糊效果的半透明卡片
渐变背景：美丽的蓝色到紫色渐变背景
平滑动画：交互元素上的悬停效果和平滑过渡
字体层次结构：清晰的信息层次结构，使用不同的字体粗细
颜色编码状态：直观的绿色/红色系统表示服务器状态
响应式布局：适应不同屏幕大小的网格系统

🔧 实用案例

该仪表盘使您能够：

快速服务器概览：一目了然地查看所有MCP服务器及其状态
个别控制：按需启用或禁用特定服务器
批量管理：开启/关闭所有服务器进行测试或维护
配置监控：跟踪更改并验证服务器状态
活动追踪：审查何时进行了哪些更改
主题偏好：选择您偏好的视觉模式以获得舒适感

预备条件

安装了Amazon Q CLI的macOS
Node.js（版本14或更高）
MCP配置文件位于~/.aws/amazonq/mcp.json

安装

克隆仓库：

git clone https://github.com/YOUR_USERNAME/q-mcp-manager.git
cd q-mcp-manager

安装依赖项：
```
npm install
```
验证您的MCP配置文件存在：
```
ls -la ~/.aws/amazonq/mcp.json
```

使用方法

🚀 快速启动（最简单）

./start.sh start --background

确保start.sh和server.sh脚本具有可执行权限（chmod +x）

✅ 服务器启动 + 仪表盘打开 + 终端空闲！

🎛️ 替代方法

选项1：直接服务器脚本

./scripts/server.sh start --background

选项2：NPM命令

npm start

选项3：开发模式

npm run dev

停止： 点击仪表盘头部的红色“关闭”按钮。

📱 书签仪表盘

http://localhost:3000  # 默认端口
http://localhost:8080  # 自定义端口示例

统一服务器控制

所有服务器操作均使用单一脚本：./scripts/server.sh

🔧 基本命令

./scripts/server.sh start [选项] - 启动服务器（自动打开浏览器）
./scripts/server.sh stop [选项] - 平稳停止服务器
./scripts/server.sh restart [选项] - 重启服务器
./scripts/server.sh status [选项] - 检查服务器状态和健康状况
./scripts/server.sh logs [--follow] - 查看服务器日志
./scripts/server.sh help - 显示所有可用命令

🌐 端口自定义（新功能！）

在任何端口运行仪表盘以避免冲突或匹配您的偏好：

默认端口（3000）：

./scripts/server.sh start --background

自定义端口选项：

# 使用 --port 标志
./scripts/server.sh start --port 8080 --background
./scripts/server.sh start -p 5000 --background --no-open

# 使用 --port= 语法
./scripts/server.sh start --port=4000 --background

# 所有命令支持自定义端口
./scripts/server.sh status --port 8080
./scripts/server.sh stop --port  8080

端口验证：

✅ 端口1-65535有效
⚠️ 端口低于1024时会显示特权警告
❌ 无效端口会被明确错误消息拒绝
🔍 自动检测端口冲突

常见用例：

多个实例：在不同端口运行不同项目的仪表盘
避免冲突：当3000被占用时使用替代端口
企业网络：使用非标准端口以避免防火墙限制
环境匹配：匹配现有的开发端口惯例

环境变量支持：

# 直接使用自定义端口执行Node.js
PORT=8080 node src/backend/server.js

# 带自定义端口的NPM脚本
PORT=8080 npm start

🌐 自动打开功能：启动服务器时，仪表盘会自动在浏览器中打开（使用--no-open禁用）

📖 详细服务器管理说明，请参阅docs/SERVER_GUIDE.md

管理MCP服务器

一旦仪表盘运行：

查看所有已配置服务器及其当前状态
单击单个服务器卡片上的启用/禁用按钮
使用“全部启用”或“全部禁用”进行批量操作
单击“刷新”以从磁盘重新加载配置

键盘快捷键

Ctrl/Cmd + R：刷新服务器
Ctrl/Cmd + E：启用所有服务器
Ctrl/Cmd + D：禁用所有服务器

API端点

后端服务器提供以下REST API端点：

GET /api/mcp-config：读取当前MCP配置
POST /api/mcp-config：更新MCP配置
POST /api/validate-config：保存前验证配置
GET /api/health：检查服务器健康状态

文件结构

q-mcp-manager/
├── src/
│   ├── backend/
│   │   └── server.js              # Express.js服务器
│   ├── frontend/
│   │   ├── dashboard/             # 主仪表盘
│   │   │   ├── index.html
│   │   │   ├── script.js
│   │   │   └── styles.css
│   │   └── home/                  # 主页启动器
│   │       ├── index.html
│   │       ├── script.js
│   │       └── styles.css
│   └── assets/                    # 静态资产及截图
│       ├── launcher.html
│       ├── start.html
│       ├── Screenshot_1.png       # 轻模式仪表盘
│       └── Screenshot_2.png       # 深模式仪表盘
├── scripts/
│   └── server.sh                  # 主服务器控制脚本
├── docs/
│   ├── QUICK_START.md             # 快速入门指南
│   └── SERVER_GUIDE.md            # 详细服务器指南
├── logs/                          # 服务器日志（自动生成）
├── start.sh                       # 方便的启动脚本
├── package.json                   # Node.js依赖项
├── CONTRIBUTING.md                # 开发指南
├── LICENSE                        # MIT许可证
├── README.md                      # 此文件
└── .gitignore                     # Git忽略规则

配置文件格式

仪表盘使用标准Amazon Q MCP配置格式：

{
  "mcpServers": {
    "server-name": {
      "command": "docker",
      "args": ["run", "--rm", "--interactive", "image:latest"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

安全特性

自动备份：在进行更改前创建带时间戳的备份
配置验证：保存前验证JSON结构
错误处理：全面的用户友好错误处理
实时状态：显示连接状态和加载状态

故障排除

服务器无法启动

确保已安装Node.js：node --version
检查端口3000是否可用：lsof -i :3000
安装依赖项：npm install

无法读取MCP配置

验证文件是否存在：ls -la ~/.aws/amazonq/mcp.json
检查文件权限：chmod 644 ~/.aws/amazonq/mcp.json
验证JSON语法：cat ~/.aws/amazonq/mcp.json | jq .

更改未生效

单击“刷新”按钮以从磁盘重新加载
检查浏览器控制台中的错误消息
验证后端服务器正在运行

开发

要贡献或修改仪表盘：

前端更改：编辑index.html，styles.css或script.js
后端更改：编辑server.js
使用开发模式：npm run dev以实现自动重载

安全注意事项

仪表盘在您的机器上本地运行
仅可通过localhost访问（不暴露于互联网）
在进行任何更改前创建备份
应用所有配置更改前进行验证

许可证

MIT许可证 - 随意修改和分发。

支持

如果您遇到任何问题：

检查浏览器控制台中的错误消息
验证您的MCP配置文件是有效的JSON
确保后端服务器正在端口3000上运行
检查MCP配置文件的文件权限