MCP Manager Local

MCP Manager Local

一个简单的本地 Web 管理器，可用于启动、停止、配置 MCP（多能力协议）服务并查看其日志，还支持从 Git 仓库克隆新服务，以及通过 JSON 添加配置。

功能

• Web 界面： 通过 http://localhost:3000 访问 Web 界面，管理 MCP 服务。
• 服务管理：
  • 手动添加服务配置。
  • 粘贴 JSON 对象以添加配置。
  • 编辑现有配置（名称、命令、参数、环境变量）。
  • 从列表中移除配置。
• 进程控制：
  • 单独启动（“开启”）和停止（“关闭”）MCP 服务进程。
  • 查看状态（运行中、已停止、错误等）。
• 日志查看： 在界面中实时查看服务的标准输出（stdout）和标准错误（stderr）。
• Git 克隆： 直接通过界面克隆包含 MCP 服务的 Git 仓库。系统会自动将克隆服务的占位项添加到列表中，供后续配置。
• 持久化： 服务配置保存在本地 servers.json 文件中。

前提条件

• Node.js： 推荐使用 18 或更高版本。（下载 Node.js）
• Git： 克隆功能所必需。（下载 Git）

安装与运行（开发）

1. 克隆仓库：

   git clone https://github.com/silastorres14/mcp-manager.git
   

2. 进入文件夹：

   cd <nome-do-repositorio>
   

3. 安装依赖：

   npm install
   

4. （可选）配置初始服务：

   • 你可以手动编辑 servers.json 文件以添加初始配置。
   • 重要： 请勿将包含机密信息（API 密钥、客户端机密）的 servers.json 文件提交到公共仓库。克隆仓库后，请使用 Web 界面添加包含机密信息的配置。仓库中的 servers.json 应仅包含示例，或保持为空。

5. 启动 MCP Manager 服务：

   node server.js
   

6. 访问界面：

   • 打开 Web 浏览器并访问 http://localhost:3000。

构建可执行文件（可选）

你可以使用 pkg 创建独立的可执行文件。

1. 运行构建脚本（在 package.json 中定义）：

   npm run build-pkg
   

   （这将运行命令 pkg . --targets ... --output ...）

2. 找到可执行文件： 可执行文件（例如，Windows 上的 mcp-manager.exe）将位于 dist/ 文件夹中。

3. 运行：

   • 重要： 将 servers.json 文件（包含初始配置或为空）复制到 dist/ 文件夹中，与可执行文件放在一起。
   • 双击可执行文件（或通过终端运行：.\mcp-manager.exe 或 ./mcp-manager）。
   • 在浏览器中访问 http://localhost:3000。
   • 使用可执行文件克隆首个仓库时，cloned_servers/ 文件夹将在 dist/ 中创建。

使用方法

1. 访问： 在浏览器中打开 http://localhost:3000。
2. 克隆服务： 使用“克隆 MCP 仓库”部分，从 Git 仓库下载服务。系统会在列表中添加一个占位项。
3. 通过 JSON 添加： 使用“通过 JSON 添加配置”部分，粘贴并添加完整配置。
4. 手动添加： 点击“手动添加服务”，并填写表单中的详细信息。
5. 管理服务：
   • 点击列表中的服务，查看其日志（如果正在运行）。
   • 使用操作按钮（▶、■、✎、🗑️）启动、停止、编辑或移除服务（仅当服务已停止时，才能执行编辑和移除操作）。
   • 编辑时，正确填写 命令、参数（以逗号分隔）和 环境变量（JSON 格式）字段，以便启动服务。必要时，请在参数中使用绝对路径。

servers.json 结构

servers.json 文件用于存储一个对象数组，每个对象代表一个已配置的 MCP 服务：

[
  {
    "id": "uuid-gerado-automaticamente",
    "name": "Nome Amigável do Servidor",
    "description": "Descrição opcional.",
    "command": "comando_para_executar", // ex: "node", "python", "/caminho/executavel"
    "args": ["argumento1", "/caminho/script.js", "--flag"], // Array de strings
    "env": { // Objeto chave-valor para variáveis de ambiente
      "VARIAVEL_1": "valor1",
      "API_KEY": "NAO_COMITAR_SEGREDOS_AQUI"
    }
  }
]