Supervisor MCP Server

MCP运维云端

提供方 masx200

运维云端 未标注 无需鉴权 社区 / 第三方

一个使用TypeScript开发的MCP服务器,用于通过supervisord的REST API进行进程管理和监控。

一句话选型结论

按资料字段整理

Supervisor MCP Server 属于运维云端类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

进程管理TypeScript本地部署日志管理配置管理系统控制HTTP日志记录

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Supervisor MCP Server当前 未标注 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方masx200上游标注的维护方 masx200
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.7 KB
来自项目仓库与上游目录的原文,未做删改

Supervisor MCP Server

一个使用 TypeScript 开发的 Model Context Protocol (MCP) 服务器,用于通过
supervisord 的 REST API 进行进程管理和监控。

🚀 技术特色

  • 官方 INI 解析 - 使用 npm 官方维护的 ini 库进行配置文件解析
  • HTTP 请求日志 - 集成 Morgan 中间件,记录所有 HTTP 请求(Apache combined
    格式)
  • Streamable HTTP - 基于 MCP SDK 的标准 Streamable HTTP 传输协议
  • 类型安全 - 完整的 TypeScript 类型定义和验证
  • 生产就绪 - 包含错误处理、日志记录、健康检查等功能

功能特性

进程管理

  • ✅ 列出程序 - 获取所有被管理程序的状态信息
  • ✅ 启动程序 - 启动单个程序
  • ✅ 停止程序 - 停止单个程序
  • ✅ 批量操作 - 批量启动/停止多个程序
  • ✅ 状态查询 - 获取单个程序的详细状态信息

日志管理

  • ✅ 日志查看 - 读取程序 stdout/stderr 日志
  • ✅ 分页读取 - 支持指定偏移和长度的分页读取
  • ✅ 末尾读取 - 从文件末尾读取指定行数
  • ✅ 文件检查 - 自动检测可读日志文件

配置管理

  • ✅ 配置查看 - 查看完整配置文件或指定节
  • ✅ 配置更新 - 更新配置项的值
  • ✅ 配置节管理 - 添加、删除配置节
  • ✅ 配置备份 - 自动备份配置文件

系统控制

  • ✅ 配置重载 - 重载 supervisord 配置
  • ✅ 健康检查 - 监控与 supervisord 的连接状态

HTTP 日志记录

  • ✅ 请求日志 - 使用 Morgan 中间件记录所有 HTTP 请求
  • ✅ 标准格式 - Apache combined 格式,支持日志分析工具
  • ✅ 实时输出 - 日志直接输出到控制台,便于实时监控
  • ✅ 高性能 - 异步日志记录,不影响服务器响应性能

安装依赖```bash

cd supervisor-mcp-server
npm install


## 配置环境变量

创建 `.env` 文件或设置以下环境变量:```bash
# Supervisord 连接配置
SUPERVISORD_HOST=127.0.0.1          # supervisord 主机地址
SUPERVISORD_PORT=9001               # supervisord HTTP 端口
SUPERVISORD_USERNAME=admin          # supervisord 用户名(可选)
SUPERVISORD_PASSWORD=password       # supervisord 密码(可选)

# 配置文件路径
SUPERVISORD_CONFIG_FILE=/etc/supervisord.conf  # supervisord 配置文件路径

# Supervisord 运行目录
SUPERVISORD_COMMAND_DIR=/var/log/supervisor     # supervisord 运行命令所在目录(用于查找日志文件)

# MCP 服务器配置
MCP_PORT=3000                       # MCP 服务器监听端口

启动服务器

开发模式```bash

npm run dev


### 生产模式```bash
npm run build
npm start

supervisord 配置

确保 supervisord 已配置 HTTP 服务器:```ini

/etc/supervisord.conf

[inet_http_server]
port=127.0.0.1:9001
username=admin
password=password

[supervisorctl]
serverurl=http://127.0.0.1:9001


## 可用的 MCP 工具

### 进程管理

#### 1. list_programs

列出所有程序及其状态。```typescript
// 使用示例
const programs = await callTool("list_programs", {});

2. start_program

启动指定程序。```typescript
const result = await callTool("start_program", {
name: "my_program",
});


#### 3. stop_program

停止指定程序。```typescript
const result = await callTool("stop_program", {
name: "my_program",
});

4. start_programs

批量启动程序。```typescript
const result = await callTool("start_programs", {
names: ["program1", "program2", "program3"],
});


#### 5. stop_programs

批量停止程序。```typescript
const result = await callTool("stop_programs", {
names: ["program1", "program2", "program3"],
});

6. get_program_status

获取单个程序的详细状态。```typescript
const status = await callTool("get_program_status", {
name: "my_program",
});


### 日志管理

#### 7. read_log

读取程序日志。```typescript
// 读取完整日志
const fullLog = await callTool("read_log", {
name: "my_program",
type: "stdout",
});

// 从文件末尾读取最近 50 行
const recentLog = await callTool("read_log", {
name: "my_program",
type: "stdout",
tail: true,
lines: 50,
});

// 从指定位置读取 1KB 数据
const partialLog = await callTool("read_log", {
name: "my_program",
type: "stdout",
offset: 1024,
length: 1024,
});

参数说明:

  • name: 程序名称
  • type: 日志类型 ('stdout' | 'stderr')
  • offset: 字节偏移(可选)
  • length: 读取字节数(可选)
  • lines: 读取行数(可选)
  • tail: 是否从文件末尾读取(默认 false)

配置管理

8. get_config

获取配置文件。```typescript
// 获取完整配置
const fullConfig = await callTool("get_config", {});

// 获取指定节
const programSection = await callTool("get_config", {
section: "program:my_program",
});


#### 9. update_config

更新配置项。```typescript
const result = await callTool("update_config", {
section: "program:my_program",
key: "command",
value: "/usr/bin/myapp --flag value",
});

系统控制

10. reload_supervisor

重载 supervisord 配置。```typescript
const result = await callTool("reload_supervisor", {});


## API 接口

服务器还提供了一些 HTTP API 端点:

### 健康检查```bash
GET /health

返回 supervisord 连接状态和服务器健康状况。

项目结构```

supervisor-mcp-server/
├── src/
│ ├── supervisordClient.ts # supervisord REST API 客户端
│ ├── logReader.ts # 日志文件读取器
│ ├── configManager.ts # 配置文件管理器
│ └── server.ts # 主服务器文件
├── package.json
├── tsconfig.json
├── .gitignore
└── README.md
```

开发说明

架构设计

  1. supervisordClient.ts - 封装 supervisord REST API 调用
  2. logReader.ts - 处理日志文件的分页读取和文件系统操作
  3. configManager.ts - 管理 INI 格式配置文件的解析和修改
  4. server.ts - 主 MCP 服务器,整合所有功能

技术栈

  • MCP SDK - Model Context Protocol TypeScript SDK
  • Express - HTTP 服务器框架
  • Axios - HTTP 客户端
  • TypeScript - 类型安全的 JavaScript

错误处理

所有工具都包含完整的错误处理,会返回详细的错误信息而不是崩溃。

日志记录

服务器会记录:

  • MCP 请求处理
  • supervisord 连接状态
  • 错误和异常情况

安全考虑

  1. 认证 - 支持 supervisord 的用户名/密码认证
  2. 权限 - 依赖 supervisord 的访问控制
  3. 配置保护 - 配置文件修改前自动备份
  4. 输入验证 - 所有输入参数都经过 zod 验证

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request!

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Supervisor MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Supervisor MCP Server 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Supervisor MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Supervisor MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Supervisor MCP Server 能提供哪些能力?

资料显示能力标签包括 进程管理、配置管理、TypeScript、日志管理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。