模式 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",
        "other"
      ],
      "customInstructions?: string;  // 可选的额外说明
    }
  ]
}

3. MCP 配置

在 MCP 中配置此服务器：

{
  "servers": {
    "modes-server": {
      "url": "http://localhost:3000",
      "plugins": ["custom-modes"]
    }
  },
  "tools": {
    "custom-modes": {
      "server": "modes-server",
      "configFile": "%APPDATA%/Code/User/globalStorage/rooveteraryinc.custom-modes/config.json"
    }
  }
}

开发

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

npm run build

3. 启动服务器：

npm start

最佳实践

1. 模式选择

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

2. 模式转换

   • 按照自然转换流程进行操作
   • 完成当前模式的任务
   • 在模式之间保留上下文

3. 配置管理

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

错误处理

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

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

测试

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

贡献指南

1. 叉克隆仓库
2. 创建功能分支
3. 提交拉取请求
4. 遵循编码标准

许可证

MIT License - 详情请参阅 LICENSE