Roo Code Memory Bank MCP Server

Integrations

  • Manages a project memory bank using Markdown files, providing tools to initialize, read, and append to structured context files that maintain project knowledge across sessions.

  • Serves as the runtime environment for the memory bank system, allowing file operations to create, check, read, and update the contextual knowledge base.

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:

{ "mcpServers": { // ... other server configurations ... "roo-code-memory-bank-mcp": { "autoApprove": [ "initialize_memory_bank", "check_memory_bank_status", "read_memory_bank_file", "append_memory_bank_entry" ], "disabled": false, "timeout": 60, "command": "node", // Or "cmd.exe" with "/c node ..." on Windows if needed "args": [ // IMPORTANT: Replace this path with the actual absolute path // to the compiled index.js file on your system "/path/to/your/cloned/repo/roo-code-memory-bank-mcp-server/dist/index.js" ], "env": {}, "transportType": "stdio" } // ... other server configurations ... } }

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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

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

Permite que los asistentes de IA mantengan un contexto de proyecto persistente en todas las sesiones almacenando y recuperando información estructurada en archivos Markdown organizados en un directorio de banco de memoria.

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration (for Cline MCP Client)
          1. Running the Server
            1. Usage
              1. Custom instructions

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol implementation that enables AI assistants to interact with markdown documentation files, providing capabilities for document management, metadata handling, search, and documentation health analysis.
              Last updated -
              14
              346
              11
              TypeScript
              MIT License
              • Apple
              • Linux
            • A
              security
              A
              license
              A
              quality
              Provides tools for interacting with Targetprocess, a project management and agile planning platform, enabling AI assistants to search, create, and update project entities with proper validation.
              Last updated -
              5
              TypeScript
              MIT License
            • A
              security
              A
              license
              A
              quality
              Memory Bank Server provides a set of tools and resources for AI assistants to interact with Memory Banks. Memory Banks are structured repositories of information that help maintain context and track progress across multiple sessions.
              Last updated -
              15
              111
              13
              TypeScript
              MIT License
            • -
              security
              A
              license
              -
              quality
              A server for managing project documentation and context across Claude AI sessions through global and branch-specific memory banks, enabling consistent knowledge management with structured JSON document storage.
              Last updated -
              317
              7
              TypeScript
              MIT License

            View all related MCP servers

            ID: 0io7cvii44