MCP Manager Local

一个简单的本地 Web 管理器，用于启动、停止、配置和查看 MCP (Multi-Capability Protocol) 服务器的日志，具有从 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 <仓库名称>
   

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。
   • 当您使用可执行文件克隆第一个仓库时，将在 dist/ 中创建 cloned_servers/ 文件夹。

如何使用

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

servers.json 的结构

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

[
  {
    "id": "uuid-自动生成",
    "name": "服务器的友好名称",
    "description": "可选描述。",
    "command": "要执行的命令", // 例如: "node", "python", "/路径/可执行文件"
    "args": ["参数1", "/路径/script.js", "--flag"], // 字符串数组
    "env": { // 环境变量的键值对对象
      "VARIAVEL_1": "值1",
      "API_KEY": "不要在这里提交机密信息"
    }
  }
]