MCP 服务器

Modes MCP Server

Modes MCP 服务器允许对自定义操作模式进行全面的管理和控制，支持完整的 CRUD 操作、模式验证和实时配置更改，从而增强模式管理。

Tools

list_modes

List all custom modes

get_mode

Get details of a specific mode

create_mode

Create a new custom mode

update_mode

Update an existing custom mode

delete_mode

Delete a custom mode

validate_mode

Validate a mode configuration without saving it

README

Modes MCP 服务器

一个用于管理 Roo 自定义操作模式的 MCP 服务器，提供对模式配置和管理的程序化控制。

功能特性

针对自定义模式的完整 CRUD 操作
使用 Zod 进行模式验证
文件系统监听配置更改
使用标准 MCP 错误代码进行错误处理
原子文件操作

安装

# 克隆仓库
git clone https://github.com/mkc909/modes-mcp-server.git
cd modes-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

配置

1. 环境变量

复制 .env.example 到 .env 并根据需要进行调整：

cp .env.example .env

可用的环境变量：

MODES_CONFIG_PATH: 自定义模式配置文件的路径 (默认: %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_custom_modes.json)

2. 自定义模式配置

创建一个 JSON 文件用于您的自定义模式配置。请参阅 examples/modes.example.json 获取格式示例：

{
  "customModes": [
    {
      "slug": "example-mode",
      "name": "示例模式",
      "roleDefinition": "示例角色定义，描述模式的功能和职责。",
      "groups": [
        "read",
        ["edit", {
          "fileRegex": "\\.md$",
          "description": "只能编辑 markdown 文件"
        }],
        "command",
        "mcp"
      ],
      "customInstructions": "示例模式的自定义说明。"
    }
  ]
}

3. MCP 设置

将服务器配置添加到您的 MCP 设置文件（通常位于 %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json）。请参阅 examples/mcp-settings.example.json 获取格式示例：

{
  "mcpServers": {
    "modes": {
      "command": "node",
      "args": ["/path/to/modes-mcp-server/build/index.js"],
      "env": {
        "MODES_CONFIG_PATH": "/path/to/custom/modes.json"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

操作模式框架

服务器管理一套全面的操作模式：

核心系统模式

规划模式 🎯
- 战略规划专家
- 系统设计和资源分配
- 项目路线图开发
分析模式 📊
- 数据分析专家
- 指标跟踪和分析
- 性能监控
研究模式 🔍
- 系统研究专家
- 最佳实践研究
- 解决方案探索
实施模式 ⚙️
- 运营实施专家
- 系统部署
- 流程执行
故障排除模式 🔧
- 系统问题解决专家
- 问题识别
- 问题解决
质量控制模式 ✅
- 质量保证专家
- 系统验证
- 性能验证
集成模式 🔄
- 系统集成专家
- 跨系统协调
- 工作流程优化
文档模式 📝
- 知识管理专家
- 流程文档
- 标准维护
会话管理模式 ⚡
- 会话管理专家
- 每日工作流程编排
- 状态管理

专业模式

交易运营经理
- 系统化的交易和风险管理
- 交易文档和分析
- 市场分析和策略优化

模式转换流程

graph TD
    A[规划] --> B[研究]
    B --> C[实施]
    C --> D[集成]
    D --> E[质量控制]
    E --> F[分析]
    F --> G[故障排除]
    G --> H[文档]
    H --> A

可用工具

list_modes

列出当前配置的所有自定义模式。

get_mode

根据 slug 获取特定模式的详细信息。

参数：

slug: 模式的唯一标识符

create_mode

创建一个新的自定义模式。

参数：

slug: 唯一标识符（小写字母、数字和连字符）
name: 模式的显示名称
roleDefinition: 模式的角色和功能的详细描述
groups: 允许的工具组数组
customInstructions: (可选) 模式的附加说明

update_mode

更新现有的自定义模式。

参数：

slug: 要更新的模式的唯一标识符
updates: 包含要更新的字段的对象（name、roleDefinition、groups、customInstructions）

delete_mode

删除一个自定义模式。

参数：

slug: 要删除的模式的唯一标识符

validate_mode

验证模式配置而不保存它。

参数：

mode: 要验证的完整模式配置对象

模式配置 Schema

interface CustomMode {
  slug: string;  // 仅限小写字母、数字和连字符
  name: string;  // 显示名称
  roleDefinition: string;  // 详细描述
  groups: (string | [string, { fileRegex: string, description: string }])[];
  customInstructions?: string;  // 可选的附加说明
}