Modes MCP Server

Modes MCP 服务

用于管理 Roo 自定义操作模式的 MCP 服务，可通过程序控制模式配置和管理。

功能

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

安装

# Clone the repository
git clone https://github.com/mkc909/modes-mcp-server.git
cd modes-mcp-server

# Install dependencies
npm install

# Build the project
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": "Example Mode",
      "roleDefinition": "Example role definition describing the mode's capabilities and responsibilities.",
      "groups": [
        "read",
        ["edit", {
          "fileRegex": "\\.md$",
          "description": "Can edit markdown files only"
        }],
        "command",
        "mcp"
      ],
      "customInstructions": "Example custom instructions for the mode."
    }
  ]
}

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": []
    }
  }
}

操作模式框架

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

核心系统模式

1. 规划模式 🎯

   • 战略规划专家
   • 系统设计和资源分配
   • 项目路线图制定

2. 分析模式 📊

   • 数据分析专家
   • 指标跟踪和分析
   • 性能监控

3. 研究模式 🔍

   • 系统研究专家
   • 最佳实践研究
   • 解决方案探索

4. 实施模式 ⚙️

   • 运维实施专家
   • 系统部署
   • 流程执行

5. 故障排除模式 🔧

   • 系统问题解决专家
   • 问题识别
   • 问题解决

6. 质量控制模式 ✅

   • 质量保证专家
   • 系统验证
   • 性能验证

7. 集成模式 🔄

   • 系统集成专家
   • 跨系统协调
   • 工作流优化

8. 文档模式 📝

   • 知识管理专家
   • 流程文档编写
   • 标准维护

9. 会话管理模式 ⚡

   • 会话管理专家
   • 每日工作流编排
   • 状态管理

专用模式

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

模式转换流程

graph TD
    A[Planning] --> B[Research]
    B --> C[Implementation]
    C --> D[Integration]
    D --> E[Quality Control]
    E --> F[Analytics]
    F --> G[Troubleshooting]
    G --> H[Documentation]
    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：要验证的完整模式配置对象

模式配置架构

interface CustomMode {
  slug: string;  // Lowercase letters, numbers, and hyphens only
  name: string;  // Display name
  roleDefinition: string;  // Detailed description
  groups: (string | [string, { fileRegex: string, description: string }])[];
  customInstructions?: string;  // Optional additional instructions
}

开发

1. 修改 src/ 中的源代码
2. 构建项目：

npm run build

3. 启动服务：

npm start

最佳实践

1. 模式选择

   • 为任务选择合适的模式
   • 遵循特定模式的工作流
   • 使用指定的工具组

2. 模式切换

   • 遵循自然的切换流程
   • 完成当前模式下的任务
   • 在不同模式间保留上下文

3. 配置管理

   • 保存前验证更改
   • 保持角色定义清晰
   • 记录模式的功能

错误处理

该服务使用标准 MCP 错误代码：

• InvalidParams：输入参数无效或未找到模式
• MethodNotFound：请求了未知工具
• InternalError：文件系统错误或其他内部问题

测试

请参阅 TESTING.md，了解全面的测试用例和验证流程。

贡献

1. Fork 仓库
2. 创建功能分支
3. 提交拉取请求
4. 遵循编码规范

许可证

MIT 许可证 - 详情请参阅 LICENSE