local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Supports environment variable configuration through .env files
Supported in the custom modes configuration with specific file permissions through fileRegex patterns
Used for visualizing mode transition flows in the documentation

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

运营模式框架

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

核心系统模式

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

专用模式

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

模式转换流程

可用工具

列表模式

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

获取模式

通过其 slug 获取特定模式的详细信息。

参数：

slug ：模式的唯一标识符

创建模式

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

参数：

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

更新模式

更新现有的自定义模式。

参数：

slug ：要更新的模式的唯一标识符
updates ：包含要更新的字段的对象（名称、角色定义、组、自定义说明）

删除模式

删除自定义模式。

参数：

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

验证模式

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

参数：

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
}

发展

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

npm run build

启动服务器：

npm start

最佳实践

模式选择
- 为任务选择合适的模式
- 遵循特定模式的工作流程
- 使用指定的工具组
模式转换
- 遵循自然过渡流程
- 完成当前模式任务
- 保留模式之间的上下文
配置管理
- 保存前验证更改
- 保持清晰的角色定义
- 文档模式功能

错误处理

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

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

测试

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

贡献

Fork 存储库
创建功能分支
提交拉取请求
遵循编码标准

执照

MIT 许可证 - 详情请参阅许可证

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Tools

通过完整的 CRUD 操作和模式验证，实现对 Roo 自定义操作模式的编程控制，从而实现无缝模式配置和管理。

Related Resources

Reddit Discussion about this server

Modes MCP Server