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

Related MCP server: MCP Server

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

graph TD
    A[Planning] --> B[Research]
    B --> C[Implementation]
    C --> D[Integration]
    D --> E[Quality Control]
    E --> F[Analytics]
    F --> G[Troubleshooting]
    G --> H[Documentation]
    H --> A

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

3. 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