Filesystem MCP Server

Un servidor para realizar operaciones del sistema de archivos como leer/escribir archivos, gestionar directorios y buscar.

Documentación

Filesystem MCP

Un servidor de Model Context Protocol (MCP) que proporciona acceso seguro al sistema de archivos para asistentes de IA en Code Maestro Desktop.

Qué hace

Este servidor MCP permite a los asistentes de IA:

  • Leer y escribir archivos
  • Crear y navegar directorios
  • Buscar archivos
  • Editar archivos existentes con precisión
  • Y más operaciones del sistema de archivos

Todas las operaciones están restringidas a los directorios que usted permita explícitamente.

¿Por qué este fork?

Hicimos un fork del @modelcontextprotocol/server-filesystem original para hacerlo más eficiente para los asistentes de IA. El paquete original podía devolver salidas extremadamente grandes que desperdiciaban tokens y abrumaban a los modelos de lenguaje.

Nuestras mejoras:

  • Límites inteligentes de lectura de archivos - Evita leer archivos gigantes completos
  • Límites en el listado de directorios - Devuelve resultados manejables incluso en carpetas con miles de archivos
  • Recorrido de árbol con profundidad limitada - Evita perderse en estructuras de carpetas profundas
  • Resultados de búsqueda optimizados - Devuelve coincidencias relevantes sin inundar la salida
  • Omitir carpetas grandes - Evita automáticamente node_modules, .git y directorios similares

Estos cambios aseguran que su asistente de IA obtenga la información que necesita sin ahogarse en datos innecesarios.

Inicio rápido

1. Abra CM Desktop y haga clic en conectores

2. Haga clic en "Agregar" y pegue el siguiente JSON:

{
  "mcpServers": {
    "Code Maestro - Filesystem MCP": {
      "transport": "stdio",
      "enabled": true,
      "command": "npx",
      "args": [
        "github:codemaestroai/filesystem-mcp",
        "<YOUR_PROJECT_PATH>"
      ],
      "env": {},
      "url": null,
      "headers": null
    }
  }
}

3. Reemplace <YOUR_PROJECT_PATH> con la ruta real a su directorio de proyecto

Rutas de ejemplo:

  • Windows: "C:\\Users\\YourName\\Projects\\my-project"
  • macOS/Linux: "/home/username/projects/my-project"

Puede especificar múltiples directorios:

"args": [
  "github:codemaestroai/filesystem-mcp",
  "/path/to/project1",
  "/path/to/project2"
]

Seguridad

  • El servidor MCP SOLO puede acceder a los directorios que usted especifique explícitamente
  • Todas las operaciones de archivos se registran
  • Los intentos de acceder a archivos fuera de los directorios permitidos serán rechazados

Nota: Esta es una solución temporal. Estamos trabajando en soporte nativo de operaciones de archivos en CM Desktop.