Skip to main content
Glama
Sign In
Proma Manager MCP Server

Proma Manager MCP Server

by climashscape
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Proma Manager MCP Server

Proma 的瑞士军刀——一个 MCP Server，管完 Skills、MCP、会话。

还在 Proma 侧边栏一个个右键删对话？想让 Skills 在所有工作区保持一致却手动复制？想知道哪些 Skill 分叉了、哪些工作区 MCP 配置掉了？这个 Server 就是答案。

它能干什么

🔄 Skill 跨工作区同步

5 个工作区的 Skill 都一致吗？一条命令查清：

Agent → check → 返回 managed / unmanaged / orphans 三张清单

分叉的 Skill？diff 看差异，sync 一键从母版覆盖到全部子工作区。新工作区缺 Skill？bootstrap 补溯源，sync 分发过去。再也不用手动复制粘贴了。

🛡️ MCP 配置审计

某天突然发现某个工作区少了 tavily MCP？mcp_check 一扫，哪些工作区缺哪些服务器、哪里配置不一致，一览无余。

📊 Skill 自动分组

侧边栏 Skill 列表太长？group_list 列出所有 Skill 的内容摘要，AI 分析后自动归纳分组，group_set 批量写入。文档类归文档，设计类归设计，半天翻不完的列表变成三五个折叠分组。

🗑️ 会话/对话管理

这是最顺手的功能——再也不用开 Proma GUI 侧边栏一个个右键删了。

  • list_sessions — 列出所有 Chat 对话和 Agent 会话（标题、时间、归档状态）

  • delete_session — 双重安全栅栏：不传 confirm 时自动 dry-run 预览（展示将删除的全部文件路径和大小），传 confirm: true 才真删。删的是真删——消息文件 .jsonl、附件、工作目录、SDK 关联数据，一个不留。

"帮我把最近一周所有叫'新对话'的无意义对话删了"——一句话，Agent 帮你搞定。

Related MCP server: hermes-gpt

安装

git clone https://github.com/climashscape/proma-manager-mcp.git
cd proma-manager-mcp
npm install
npm run build

配置

在你的 Proma 工作区 mcp.json 中加入（所有工作区都建议加）：

{
  "servers": {
    "proma-manager": {
      "type": "stdio",
      "enabled": true,
      "command": "node",
      "args": ["/absolute/path/to/proma-manager-mcp/build/index.js"]
    }
  }
}

重启 Proma，mcp__proma-manager__* 系列工具自动可用。

配套 Skill

本仓库自带 proma-manager Skill（proma-manager/SKILL.md），安装后需手动复制到工作区才能生效：

# 以默认工作区为例
cp proma-manager/ ~/.proma/agent-workspaces/default/skills/proma-manager/

或者通过 Proma Manager 自身的 sync 工具分发到所有工作区。

装好 Skill 后，AI 就知道什么场景该用哪个工具了——比如你说"帮我删了所有叫新对话的无意义对话"，AI 会自动调用 list_sessions 列出 + delete_session 批量删除。

10 个工具一览

工具

一句话

check

全量扫描所有工作区 skill 同步状态（managed / unmanaged / orphans）

diff

对比母版与子版 skill 的完整差异（文件级 + 行级）

sync

从母工作区推送 skill 到子工作区（自动备份 + 覆盖 + 更新溯源）

bootstrap

给跨工作区但缺 .source.json 的 Skill 补溯源文件

info

查看一个 Skill 在各工作区的完整状态（是否存在 / hash / 文件清单）

mcp_check

扫描所有工作区 mcp.json，找出缺失和不一致的 MCP 配置

group_list

列出 Skill 的分组状态和内容摘要（供 AI 自动分组用）

group_set

批量写入 Skill 分组（与 group_list 配合实现 AI 自动归类）

list_sessions

列出所有 Chat 对话和 Agent 会话（标题 / 时间 / 归档状态）

delete_session

删除对话或会话——不传 confirm 时 dry-run 预览，confirm:true 才真删

依赖

  • Node.js >= 18

  • @modelcontextprotocol/sdk ^1.0.0

License

MIT

Available Tools

10 tools
bootstrapA

为跨工作区但缺少 .source.json 的 skill 补溯源文件。指定 skill 名、目标工作区和来源工作区。自动拒绝 default-skills（workspace-watcher 管理的 19 个 skill）。

Inputs: skill (required), workspace (required), sourceWorkspace (required).

checkA

全量扫描所有工作区，返回跨工作区 skill 的同步状态。单工作区独有 skill 也会检测错误 .source.json（声称来源但源不存在）并报告为 orphan。排除 default-skills 管理的 watcher 同步 skill。返回 managed（有 .source.json）、unmanaged（跨区但缺 .source.json）、orphans（.source.json 指向不存在的母工作区）三组清单。

Inputs: no named parameters.

delete_sessionA

删除指定的 Chat 对话或 Agent 会话。不可逆操作——会同时清理消息文件（.jsonl）、附件和工作目录。建议在 Proma 关闭或切换到其他会话后操作，避免与运行中进程冲突。不传 confirm 或 confirm=false 时仅预览（dry-run），列出将删除的文件/目录及其大小；传 confirm=true 才真正执行删除。

Inputs: id (required), type (required), confirm.

diffB

对比母版和某个子版 skill 的完整目录差异（文件级 + 行级）。需指定 skill 名和目标工作区 slug。自动拒绝 default-skills（workspace-watcher 管理的 19 个 skill）。

Inputs: skill (required), workspace (required).

group_listA

列出指定工作区所有 skill 的 group 状态和内容摘要，供 AI 分析后自动分配 group。自动排除 default-skills 管理的 19 个 watcher 同步 skill。返回每个 skill 的 name、description、当前 group、正文预览。默认扫描 default 工作区。

Inputs: workspace.

group_setA

写入 SKILL.md frontmatter 的 group 字段。接受 skill 名到 group 值的映射，批量更新。已有 group 的会被替换，没有的新增。自动拒绝 default-skills（workspace-watcher 管理的 19 个 skill）。

Inputs: groups (required), workspace (required).

infoA

查看单个 skill 的完整溯源视图：各工作区是否存在、hash、文件清单、母/子关系。

Inputs: skill (required).

list_sessionsA

列出 Proma 的所有 Chat 对话和 Agent 会话。返回标题、时间、归档状态、工作区等元数据。可按 type 参数筛选。

Inputs: type.

mcp_checkA

扫描所有工作区的 mcp.json，返回服务器合集和各工作区缺失的服务器。用于保持所有工作区 MCP 配置一致——每个服务器要么在所有工作区都有，要么只在需要的工作区有。

Inputs: no named parameters.

syncA

从母工作区推送 skill 整目录到一个或多个子工作区。先备份子版到 .sync-backup/ 再覆盖，更新 .source.json。首次分发时用 sourceWorkspace 参数指定母工作区。自动拒绝 default-skills（workspace-watcher 管理的 19 个 skill）。

Inputs: skill (required), workspaces (required), sourceWorkspace.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A3.9/5.0

    Scored across 10 tools

    Disambiguation4/5

    Each tool targets a distinct aspect: sync pushes, bootstrap fixes provenance, info queries a single skill, mcp_check handles MCP configs, group_list/group_set manage group metadata, list/delete_session handle sessions, diff compares versions, and check scans overall status. There is minor potential confusion between 'check' and 'mcp_check' but their descriptions clearly separate skills vs MCP configs.

    Naming Consistency2/5

    Tool naming is inconsistent: some are single verbs (sync, bootstrap, check, diff), some are verb_noun (list_sessions, delete_session), some are noun_verb (group_list, group_set, mcp_check), and 'info' is a noun. This mix of conventions makes the API surface less predictable.

    Tool Count5/5

    10 tools is well within the ideal 3-15 range for a management server. Each tool covers a necessary function without bloat, and the count feels proportional to the server's scope.

    Completeness5/5

    The tool set covers the full lifecycle for the server's purpose: skill sync (sync, diff, check), provenance management (bootstrap, info), group management (group_list, group_set), MCP config consistency (mcp_check), and session operations (list_sessions, delete_session). No obvious dead ends or missing critical operations.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • hermes-gpt

      DeployFaith
      A
      license
      C
      quality
      D
      maintenance
      MCP sidecar for Hermes Agent exposing operator tools (cron, skills, config, workspace) with tiered read-only/operator/owner modes and dry-run by default for safe local development.
      43
      1
      MIT

    • librechat-mcp

      Ricky-Hao
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables administration of LibreChat through MCP, providing tools to manage Skills, Agents, scheduled tasks, Prompt library, and visibility/permissions. It also offers a generic API request tool for interacting with upstream endpoints.
      MIT
    • ChatRail MCP server

      ChatRail MCP serverofficial

      chatrail
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables managing a ChatRail workspace from MCP clients, including checking WhatsApp connection health, looking up groups, tracing message failures, scheduling messages, and replaying webhook deliveries.
      14 npm
      MIT