Ccc0168 Modes MCP Server

🚀 Modes MCP Server

An MCP server for managing custom operation modes of Roo, offering programmatic control over mode configuration and management.

🚀 Quick Start

The Modes MCP Server is designed to manage custom operation modes of Roo. It provides programmatic control for mode configuration and management.

✨ Features

• Complete CRUD operations (Create, Read, Update, Delete) for custom modes.
• Schema validation using Zod.
• File system monitoring to detect configuration changes.
• Standard MCP error code handling.
• Atomic file operations.

📦 Installation

# 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

📚 Documentation

1. Environment Variables

Copy .env.example to .env and adjust as needed:

cp .env.example .env

Available environment variables:

• MODES_CONFIG_PATH: Path to the custom modes configuration file (Default: %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_custom_modes.json)

2. Custom Modes Configuration

Create a JSON file for your custom modes configuration. Check examples/modes.example.json for the format:

{
  "customModes": [
    {
      "slug": "example-mode",
      "name": "Example Mode",
      "roleDefinition": "A role definition describing the capabilities and responsibilities of the mode.",
      "groups": [
        "read",
        ["edit", {
          "fileRegex": "\\.md$",
          "description": "Can only edit Markdown files"
        }],
        "command",
        "other"
      ],
      "customInstructions?: string;  // Optional additional instructions
    }
  ]
}

3. MCP Configuration

Configure this server in 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"
    }
  }
}

💻 Usage Examples

Basic Usage

1. Modify the source code in src/.
2. Build the project:

npm run build

3. Start the server:

npm start

Best Practices

1. Mode Selection
   • Choose the appropriate mode based on the task.
   • Follow the mode-specific workflow.
   • Use the designated toolset.
2. Mode Transition
   • Operate according to the natural transition process.
   • Complete the tasks in the current mode.
   • Preserve context between modes.
3. Configuration Management
   • Validate changes before saving.
   • Keep clear role definitions.
   • Document the capabilities of the modes.

🔧 Technical Details

Error Handling

The server uses standard MCP error codes:

• InvalidParams: Invalid input parameters or mode not found.
• MethodNotFound: The requested tool is unknown.
• InternalError: File system error or other internal issues.

Testing

Refer to TESTING.md for comprehensive test cases and validation procedures.

Contribution Guidelines

1. Fork the repository.
2. Create a feature branch.
3. Submit a pull request.
4. Follow the coding standards.

📄 License

MIT License - See LICENSE for details.