MCP Manager Local

🚀 本地 MCP 管理器

本地 MCP 管理器是一个简单的网络管理界面，可用于启动、停止、配置和查看 MCP（多功能协议）服务器的日志。它支持通过 Git 克隆新的仓库，还能使用 JSON 添加配置，为 MCP 服务器的管理提供了便捷的解决方案。

🚀 快速开始

在使用本地 MCP 管理器之前，请确保满足以下先决条件，然后按照安装和运行步骤操作，即可开启 MCP 服务器的管理之旅。

✨ 主要特性

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

📦 安装指南

先决条件

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

安装步骤

1. 克隆项目仓库：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 安装依赖项：

   npm install
   

运行步骤

node index.js

然后打开浏览器访问 http://localhost:3000。

📚 详细文档

服务器配置

每个 MCP 服务器由以下字段定义：

[
  {
    "id": "自动生成的唯一标识符",
    "name": "服务器友好名称",
    "description": "可选描述。",
    "command": "要执行的命令", // 示例："node", "python", "/绝对路径/可执行文件"
    "args": ["参数1", "/绝对路径/script.js", "--标志"], // 字符串数组
    "env": { // 环境变量键值对
      "环境变量_1": "值1",
      "API_KEY": "不要在此处提交机密信息！"
    }
  }
]

使用说明

克隆仓库

git clone https://github.com/your-repository.git
cd your-repository
npm install
node index.js

添加配置

• 通过 JSON 粘贴：
  • 复制以下示例 JSON 到剪贴板：

    [
      {
        "name": "我的 MCP 服务器",
        "command": "node",
        "args": ["index.js"],
        "env": {
          "NODE_ENV": "production"
        }
      }
    ]
    

  • 在网页界面选择“通过 JSON 添加配置”并粘贴内容。
• 手动添加：
  • 点击“添加服务器”按钮。
  • 填写所有字段并保存。

启动和停止

• 点击列表中服务器旁边的播放（▶）或停止（■）按钮。
• 仅在服务器已停止时显示编辑（✎）和删除（🗑️）选项。