Modes MCP Server

by ccc0168
Verified

local-only server

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

Integrations

  • Used for environment variable configuration through .env files

  • Used for version control and cloning the repository

  • Used as the source repository for the MCP server code

Modos del servidor MCP

Un servidor MCP para administrar los modos operativos personalizados de Roo, que proporciona control programático sobre la configuración y gestión de los modos.

Características

  • Operaciones CRUD completas para modos personalizados
  • Validación de esquemas con Zod
  • Sistema de archivos que vigila los cambios de configuración
  • Manejo de errores con códigos de error MCP estándar
  • Operaciones con archivos atómicos

Instalación

# 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

Configuración

1. Variables de entorno

Copie .env.example a .env y ajuste según sea necesario:

cp .env.example .env

Variables de entorno disponibles:

  • MODES_CONFIG_PATH : Ruta al archivo de configuración de modos personalizados (predeterminado: %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_custom_modes.json )

2. Configuración de modos personalizados

Cree un archivo JSON para la configuración de sus modos personalizados. Consulte examples/modes.example.json para ver el formato:

{ "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. Configuración del MCP

Agregue la configuración del servidor a su archivo de configuración de MCP (normalmente en %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json ). Consulte examples/mcp-settings.example.json para ver el formato:

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

Marco de modos operativos

El servidor gestiona un conjunto completo de modos operativos:

Modos del sistema central

  1. Modo de planificación 🎯
    • Especialista en Planificación Estratégica
    • Diseño de sistemas y asignación de recursos
    • Desarrollo de la hoja de ruta del proyecto
  2. Modo de análisis 📊
    • Experto en análisis de datos
    • Seguimiento y análisis de métricas
    • Monitoreo del rendimiento
  3. Modo de investigación 🔍
    • Especialista en investigación de sistemas
    • Investigación de mejores prácticas
    • Exploración de soluciones
  4. Modo de implementación ⚙️
    • Experto en Implementación de Operaciones
    • Implementación del sistema
    • Ejecución del proceso
  5. Modo de solución de problemas 🔧
    • Especialista en resolución de sistemas
    • Identificación del problema
    • Resolución de problemas
  6. Modo de control de calidad
    • Experto en garantía de calidad
    • Validación del sistema
    • Verificación del rendimiento
  7. Modo de integración 🔄
    • Especialista en Integración de Sistemas
    • Coordinación entre sistemas
    • Optimización del flujo de trabajo
  8. Modo de documentación 📝
    • Especialista en Gestión del Conocimiento
    • Documentación de procesos
    • Mantenimiento estándar
  9. Modo de gestión de sesiones
    • Especialista en gestión de sesiones
    • Orquestación del flujo de trabajo diario
    • Gestión estatal

Modos especializados

  • Gerente de operaciones comerciales
    • Comercio sistemático y gestión de riesgos
    • Documentación y análisis comercial
    • Análisis de mercado y optimización de estrategias

Flujo de transición modal

Herramientas disponibles

modos de lista

Enumera todos los modos personalizados configurados actualmente.

modo_obtener

Obtenga detalles de un modo específico por su slug.

Parámetros:

  • slug : El identificador único del modo

modo de creación

Crear un nuevo modo personalizado.

Parámetros:

  • slug : Identificador único (letras minúsculas, números y guiones)
  • name : Nombre para mostrar del modo
  • roleDefinition : Descripción detallada del rol y las capacidades del modo
  • groups : Matriz de grupos de herramientas permitidos
  • customInstructions : (opcional) Instrucciones adicionales para el modo

modo de actualización

Actualizar un modo personalizado existente.

Parámetros:

  • slug : El identificador único del modo a actualizar
  • updates : Objeto que contiene los campos a actualizar (nombre, definición de rol, grupos, instrucciones personalizadas)

modo de eliminación

Eliminar un modo personalizado.

Parámetros:

  • slug : El identificador único del modo a eliminar

modo de validación

Validar una configuración de modo sin guardarla.

Parámetros:

  • mode : Objeto de configuración de modo completo para validar

Esquema de configuración de modo

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 }

Desarrollo

  1. Realizar cambios en el código fuente en src/
  2. Construir el proyecto:
npm run build
  1. Iniciar el servidor:
npm start

Mejores prácticas

  1. Selección de modo
    • Elija el modo apropiado para la tarea
    • Seguir flujos de trabajo específicos del modo
    • Utilice grupos de herramientas designados
  2. Transiciones de modo
    • Seguir el flujo de transición natural
    • Completar tareas del modo actual
    • Preservar el contexto entre modos
  3. Gestión de la configuración
    • Validar los cambios antes de guardar
    • Mantener definiciones claras de roles
    • Capacidades del modo documento

Manejo de errores

El servidor utiliza códigos de error MCP estándar:

  • InvalidParams : parámetros de entrada no válidos o modo no encontrado
  • MethodNotFound : Herramienta desconocida solicitada
  • InternalError : Errores del sistema de archivos u otros problemas internos

Pruebas

Consulte TESTING.md para obtener casos de prueba completos y procedimientos de validación.

Contribuyendo

  1. Repositorio de bifurcaciones
  2. Crear rama de características
  3. Enviar solicitud de extracción
  4. Seguir los estándares de codificación

Licencia

Licencia MIT: consulte LICENCIA para obtener más detalles

You must be authenticated.

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

El servidor Modes MCP permite una gestión y un control integrales de los modos operativos personalizados, y admite operaciones CRUD completas, validación de esquemas y cambios de configuración en tiempo real para una mejor gestión de los modos.

  1. Features
    1. Installation
      1. Configuration
        1. 1. Environment Variables
        2. 2. Custom Modes Configuration
        3. 3. MCP Settings
      2. Operational Modes Framework
        1. Core System Modes
        2. Specialized Modes
      3. Mode Transition Flow
        1. Available Tools
          1. list_modes
          2. get_mode
          3. create_mode
          4. update_mode
          5. delete_mode
          6. validate_mode
        2. Mode Configuration Schema
          1. Development
            1. Best Practices
              1. Error Handling
                1. Testing
                  1. Contributing
                    1. License
                      ID: kxbyxtgfut