Skip to main content
Glama
enesjakozh

Modes MCP Server

by ccc0168
GitHub
31
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Modes MCP Server

An MCP server for managing Roo's custom operational modes, providing programmatic control over mode configuration and management.

Features

  • Full CRUD operations for custom modes
  • Schema validation with Zod
  • File system watching for config changes
  • Error handling with standard MCP error codes
  • 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

Configuration

1. Environment Variables

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

cp .env.example .env

Available environment variables:

  • MODES_CONFIG_PATH: Path to 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. See examples/modes.example.json for the format:

{ "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 Settings

Add the server configuration to your MCP settings file (typically at %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json). See examples/mcp-settings.example.json for the format:

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

Operational Modes Framework

The server manages a comprehensive set of operational modes:

Core System Modes

  1. Planning Mode 🎯
    • Strategic Planning Specialist
    • System design and resource allocation
    • Project roadmap development
  2. Analytics Mode 📊
    • Data Analysis Expert
    • Metrics tracking and analysis
    • Performance monitoring
  3. Research Mode 🔍
    • System Research Specialist
    • Best practices research
    • Solution exploration
  4. Implementation Mode ⚙️
    • Operations Implementation Expert
    • System deployment
    • Process execution
  5. Troubleshooting Mode 🔧
    • System Resolution Specialist
    • Problem identification
    • Issue resolution
  6. Quality Control Mode ✅
    • Quality Assurance Expert
    • System validation
    • Performance verification
  7. Integration Mode 🔄
    • Systems Integration Specialist
    • Cross-system coordination
    • Workflow optimization
  8. Documentation Mode 📝
    • Knowledge Management Specialist
    • Process documentation
    • Standard maintenance
  9. Session Management Mode ⚡
    • Session Management Specialist
    • Daily workflow orchestration
    • State management

Specialized Modes

  • Trade Ops Manager
    • Systematic trading and risk management
    • Trade documentation and analysis
    • Market analysis and strategy optimization

Mode Transition Flow

Available Tools

list_modes

Lists all custom modes currently configured.

get_mode

Get details of a specific mode by its slug.

Parameters:

  • slug: The unique identifier of the mode

create_mode

Create a new custom mode.

Parameters:

  • slug: Unique identifier (lowercase letters, numbers, and hyphens)
  • name: Display name for the mode
  • roleDefinition: Detailed description of the mode's role and capabilities
  • groups: Array of allowed tool groups
  • customInstructions: (optional) Additional instructions for the mode

update_mode

Update an existing custom mode.

Parameters:

  • slug: The unique identifier of the mode to update
  • updates: Object containing the fields to update (name, roleDefinition, groups, customInstructions)

delete_mode

Delete a custom mode.

Parameters:

  • slug: The unique identifier of the mode to delete

validate_mode

Validate a mode configuration without saving it.

Parameters:

  • mode: Complete mode configuration object to validate

Mode Configuration Schema

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 }

Development

  1. Make changes to the source code in src/
  2. Build the project:
npm run build
  1. Start the server:
npm start

Best Practices

  1. Mode Selection
    • Choose appropriate mode for task
    • Follow mode-specific workflows
    • Use designated tool groups
  2. Mode Transitions
    • Follow natural transition flow
    • Complete current mode tasks
    • Preserve context between modes
  3. Configuration Management
    • Validate changes before saving
    • Maintain clear role definitions
    • Document mode capabilities

Error Handling

The server uses standard MCP error codes:

  • InvalidParams: Invalid input parameters or mode not found
  • MethodNotFound: Unknown tool requested
  • InternalError: File system errors or other internal issues

Testing

See TESTING.md for comprehensive test cases and validation procedures.

Contributing

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

License

MIT License - see LICENSE for details

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

local-only server

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

Tools

모드 MCP 서버를 사용하면 사용자 정의 운영 모드에 대한 포괄적인 관리 및 제어가 가능하며, 전체 CRUD 작업, 스키마 검증, 실시간 구성 변경을 지원하여 향상된 모드 관리를 구현할 수 있습니다.

  1. 특징
    1. 설치
      1. 구성
        1. 1. 환경 변수
        2. 2. 사용자 정의 모드 구성
        3. 3. MCP 설정
      2. 운영 모드 프레임워크
        1. 핵심 시스템 모드
        2. 특수 모드
      3. 모드 전환 흐름
        1. 사용 가능한 도구
          1. 목록_모드
          2. get_mode
          3. 생성_모드
          4. 업데이트 모드
          5. 삭제_모드
          6. 검증 모드
        2. 모드 구성 스키마
          1. 개발
            1. 모범 사례
              1. 오류 처리
                1. 테스트
                  1. 기여하다
                    1. 특허

                      Related Resources

                      Related MCP Servers

                      • MCP Server

                        la-rebelion
                        -
                        security
                        A
                        license
                        -
                        quality
                        MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
                        Last updated -
                        2
                        4
                        MIT License

                      • MCP Server

                        agentico-dev
                        -
                        security
                        A
                        license
                        -
                        quality
                        MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
                        Last updated -
                        1
                        3
                        MIT License

                      • MCP Remote Server

                        sirmews
                        -
                        security
                        F
                        license
                        -
                        quality
                        A configurable MCP server that dynamically loads capabilities from a remote configuration to bridge MCP clients with remote APIs for executing actions, accessing resources, and utilizing prompt templates.
                        Last updated -
                        659
                        5

                      • MCP Async Server

                        ViezeVingertjes
                        -
                        security
                        A
                        license
                        -
                        quality
                        This server implements the Model Context Protocol (MCP) to handle asynchronous tasks with real-time status tracking, robust error handling, and automatic resource management.
                        Last updated -
                        1
                        MIT License

                      View all related MCP servers

                      Appeared in Searches

                      New MCP Servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/ccc0168/modes-mcp-server'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server