Modes MCP Server

Modes MCP Server is an MCP server that provides programmatic management over custom operational modes in the Roo Cline coding assistant. It connects directly to Roo Cline configuration storage on your file system, allowing AI agents or developers to inspect, create, modify, and delete custom agent modes dynamically. Developers who configure multi-agent or multi-role workflows inside Roo Cline use this server to automate mode management instead of manually updating configuration files. The server exposes full CRUD operations validated against Zod schemas, offering tools to list active modes, retrieve specific mode definitions by slug, create new roles with tailored file access rules, update mode parameters, and delete obsolete profiles. It ensures safe writes through atomic file operations and includes built-in validation to check mode configurations prior to applying changes. By integrating this server into your MCP setup, you enable operational workflows where the agent adapts its own system prompts, permissions, and tool groups depending on the task.

Category: AI & LLM Tooling

Tags: automation, configuration, roo, workflow

Visit Modes MCP Server

How to install and configure Modes MCP Server

1. Clone the repository and navigate into the directory: bash git clone https://github.com/ccc0168/modes-mcp-server.git cd modes-mcp-server 2. Install dependencies and compile the TypeScript code: bash npm install npm run build 3. Copy the example environment file if you need to customize the configuration path: bash cp .env.example .env 4. Register the server in your MCP client configuration file (such as cline_mcp_settings.json): 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": [] } } }

What you can do with Modes MCP Server

• Creating custom modes dynamically with restricted tool groups and scoped file access patterns like markdown-only editing. - Reading and listing existing Roo Cline modes to inspect configured system prompts, role definitions, and permissions. - Updating role instructions or tool permissions across active modes programmatically during complex development tasks. - Validating prospective mode schemas with Zod checks prior to committing changes to the main configuration file. - Removing outdated or single-use operational modes from the Roo configuration store cleanly via automated agent tools.

Key facts

• https://github.com/ccc0168/modes-mcp-server
• AI & LLM Tooling
• automation, configuration, roo, workflow

Part of MCP Servers

What is Modes MCP Server?

Modes MCP Server is a Model Context Protocol server that manages custom operational modes for the Roo Cline coding assistant. It allows AI clients to programmatically list, create, update, delete, and validate custom modes stored in JSON configuration files.

How do I install Modes MCP Server?

Clone the repository using git, run npm install to install the required dependencies, and execute npm run build to compile the server. Then add the built index.js script and any relevant environment variables to your MCP client settings file.

What tools are available in Modes MCP Server?

The server provides list_modes, get_mode, create_mode, update_mode, delete_mode, and validate_mode. These tools allow full programmatic CRUD management and validation of operational mode definitions and tool group assignments.

Is Modes MCP Server open source?

Yes, Modes MCP Server is open source and distributed under the MIT License on GitHub.