Roo Code Memory Bank MCP Server

Servidor MCP del banco de memoria de código Roo

Este proyecto implementa la funcionalidad principal del sistema Roo Code Memory Bank como servidor de Protocolo de Contexto de Modelo (MCP). Permite a los asistentes de IA mantener el contexto del proyecto en todas las sesiones interactuando con un banco de memoria basado en archivos mediante herramientas MCP estructuradas.

Características

Este servidor MCP proporciona las siguientes herramientas:

• initialize_memory_bank : crea el directorio memory-bank/ y los archivos .md estándar ( productContext.md , activeContext.md , progress.md , decisionLog.md , systemPatterns.md ) con plantillas iniciales.
  • Entrada : (opcional) { "project_brief_content": string }
  • Salida : { "status": "success" | "error", "messages"?: string[], "message"?: string }
• check_memory_bank_status : comprueba si el directorio memory-bank/ existe y enumera los archivos .md que contiene.
  • Aporte : {}
  • Salida : { "exists": boolean, "files": string[] }
• read_memory_bank_file : lee el contenido completo de un archivo de banco de memoria especificado.
  • Entrada : { "file_name": string }
  • Salida : { "content": string } u objeto de error.
• append_memory_bank_entry : Añade una nueva entrada con marca de tiempo a un archivo específico, opcionalmente bajo un encabezado Markdown específico. Crea el archivo si no existe.
  • Entrada : { "file_name": string, "entry": string, "section_header"?: string }
  • Salida : { "status": "success" | "error", "message": string }

Prerrequisitos

• Node.js (se recomienda v18 o posterior)
• npm (generalmente incluido con Node.js)
• Un entorno de cliente MCP (como el utilizado por Cline) capaz de gestionar y lanzar servidores MCP.

Instalación

1. Clonar el repositorio:
   git clone https://github.com/IncomeStreamSurfer/roo-code-memory-bank-mcp-server.git cd roo-code-memory-bank-mcp-server
2. Instalar dependencias:
   npm install
3. Construir el proyecto:
   npm run build
   Esto compila el código TypeScript en JavaScript en el directorio dist/ .

Configuración (para el cliente Cline MCP)

Para que este servidor esté disponible para su asistente de IA (como Cline), debe agregar su configuración a su archivo de configuración de MCP (por ejemplo, cline_mcp_settings.json ).

Busque el objeto mcpServers en su archivo de configuración y agregue la siguiente entrada:

Importante: Reemplace /path/to/your/cloned/repo/ con la ruta absoluta correcta a la ubicación donde clonó el repositorio en su equipo. Asegúrese de que el separador de ruta sea el correcto para su sistema operativo (por ejemplo, use barras invertidas \ en Windows).

Ejecución del servidor

Normalmente no es necesario ejecutar el servidor manualmente. El cliente MCP (como Cline) iniciará automáticamente el servidor usando el command y args especificados en el archivo de configuración al llamar a una de sus herramientas por primera vez.

Si desea probarlo manualmente, puede ejecutar npm start desde el directorio del proyecto.

Uso

El asistente de IA interactúa con el servidor mediante las herramientas definidas. El flujo de trabajo típico implica:

1. Comprobación del estado del banco de memoria ( check_memory_bank_status ).
2. Inicializando si es necesario ( initialize_memory_bank ).
3. Leyendo archivos relevantes ( read_memory_bank_file ) para obtener contexto.
4. Agregar entradas ( append_memory_bank_entry ) a medida que se toman decisiones o se produce progreso.

El directorio memory-bank/ se creará en el mismo directorio donde se inicia el proceso del servidor (que debe ser la raíz de este directorio de proyecto cuando se inicia a través de la configuración del cliente MCP).

Instrucciones personalizadas

Establezca estas instrucciones dentro de Roo

Debes usar MCP donde sea necesario

Tengo un flujo MCP específico:

Utilice context7 para encontrar cualquier pieza de documentación relevante que necesitará para este proceso, asegúrese de alimentar cualquier conocimiento relevante a cualquier subtarea relevante - utilice context7 en todo momento para investigar documentación importante si no está seguro de algo Utilice Google Maps MCP para buscar + - esto nos permitirá encontrar los negocios básicos que necesitamos para realizar nuestra tarea Utilice Brave Search MCP para encontrar URL para raspar Utilice Fetch MCP con fetch_txt y fetch_markdown para encontrar texto e imágenes en páginas para convertir en archivos JSON y crear algo en profundidad Utilice la búsqueda de Openrouter para encontrar el sentimiento general de los temas, revisiones, etc.

Utilice el servidor roo-code-memory-bank-mcp para mantener el contexto del proyecto:

• Al comienzo de una tarea o subtarea importante, utilice check_memory_bank_status .
• Si el banco de memoria existe ( exists: true ), utilice read_memory_bank_file para los archivos relevantes (por ejemplo, productContext.md , activeContext.md ) para cargar el contexto del proyecto actual.
• Incorpore este contexto cargado en su planificación y ejecución.
• Al tomar decisiones importantes, actualizaciones de progreso o cambios arquitectónicos, utilice append_memory_bank_entry para registrar la información en el archivo apropiado ( decisionLog.md , progress.md , etc.), garantizando la persistencia del contexto.
• Si el banco de memoria no existe, considere usar initialize_memory_bank si es apropiado para el proyecto.