金大哥 - mcp-manager-local MCP 详情

article

README

🚀 本地 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）。

安装步骤

克隆项目仓库：

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

安装依赖项：
```
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 添加配置”并粘贴内容。

手动添加：
- 点击“添加服务器”按钮。
- 填写所有字段并保存。

启动和停止

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

mcp-manager-local