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:
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
- 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
- Modo de análisis 📊
- Experto en análisis de datos
- Seguimiento y análisis de métricas
- Monitoreo del rendimiento
- Modo de investigación 🔍
- Especialista en investigación de sistemas
- Investigación de mejores prácticas
- Exploración de soluciones
- Modo de implementación ⚙️
- Experto en Implementación de Operaciones
- Implementación del sistema
- Ejecución del proceso
- Modo de solución de problemas 🔧
- Especialista en resolución de sistemas
- Identificación del problema
- Resolución de problemas
- Modo de control de calidad ✅
- Experto en garantía de calidad
- Validación del sistema
- Verificación del rendimiento
- Modo de integración 🔄
- Especialista en Integración de Sistemas
- Coordinación entre sistemas
- Optimización del flujo de trabajo
- Modo de documentación 📝
- Especialista en Gestión del Conocimiento
- Documentación de procesos
- Mantenimiento estándar
- 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 modoroleDefinition : Descripción detallada del rol y las capacidades del modogroups : Matriz de grupos de herramientas permitidoscustomInstructions : (opcional) Instrucciones adicionales para el modo
modo de actualización
Actualizar un modo personalizado existente.
Parámetros:
slug : El identificador único del modo a actualizarupdates : 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
- Realizar cambios en el código fuente en
src/ - Construir el proyecto:
- Iniciar el servidor:
Mejores prácticas
- Selección de modo
- Elija el modo apropiado para la tarea
- Seguir flujos de trabajo específicos del modo
- Utilice grupos de herramientas designados
- Transiciones de modo
- Seguir el flujo de transición natural
- Completar tareas del modo actual
- Preservar el contexto entre modos
- 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 encontradoMethodNotFound : Herramienta desconocida solicitadaInternalError : 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
- Repositorio de bifurcaciones
- Crear rama de características
- Enviar solicitud de extracción
- Seguir los estándares de codificación
Licencia
Licencia MIT: consulte LICENCIA para obtener más detalles