Filesystem MCP Server

Servidor MCP del sistema de archivos [MOD]

Servidor Node.js que implementa el Protocolo de Contexto de Modelo (MCP) para operaciones del sistema de archivos. Esta es una bifurcación de https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem

Cambios:

• Independiente, sin dependencias del proyecto raíz
• Se pueden utilizar expresiones regulares para definir el directorio permitido.
• Conversión automática entre barra diagonal (/) y barra diagonal inversa ()

Características

• Leer/escribir archivos
• Crear/enumerar/eliminar directorios
• Mover archivos/directorios
• Buscar archivos
• Obtener metadatos de archivos

Nota : El servidor solo permitirá operaciones dentro de los directorios especificados mediante args .

API

Recursos

• file://system : Interfaz de operaciones del sistema de archivos

Herramientas

• leer_archivo
  • Leer el contenido completo de un archivo
  • Entrada: path (cadena)
  • Lee el contenido completo del archivo con codificación UTF-8
• leer_múltiples_archivos
  • Leer varios archivos simultáneamente
  • Entrada: paths (cadena[])
  • Las lecturas fallidas no detendrán toda la operación
• escribir_archivo
  • Crear un nuevo archivo o sobrescribir uno existente (tenga cuidado con esto)
  • Entradas:
    • path (cadena): Ubicación del archivo
    • content (cadena): contenido del archivo
• archivo_de_edición
  • Realice ediciones selectivas utilizando coincidencia de patrones y formato avanzados
  • Características:
    • Coincidencia de contenido basada en líneas y multilíneas
    • Normalización de espacios en blanco con conservación de sangría
    • Múltiples ediciones simultáneas con posicionamiento correcto
    • Detección y conservación del estilo de sangría
    • Salida de diferencias al estilo Git con contexto
    • Vista previa de los cambios con el modo de ejecución en seco
  • Entradas:
    • path (cadena): Archivo a editar
    • edits (matriz): Lista de operaciones de edición
      • oldText (cadena): Texto a buscar (puede ser una subcadena)
      • newText (cadena): Texto con el que reemplazar
    • dryRun (booleano): Vista previa de los cambios sin aplicarlos (valor predeterminado: falso)
  • Devuelve información detallada de diferencias y coincidencias para ejecuciones en seco; de lo contrario, aplica los cambios.
  • Práctica recomendada: utilice siempre dryRun primero para obtener una vista previa de los cambios antes de aplicarlos
• crear_directorio
  • Crear un nuevo directorio o asegurarse de que exista
  • Entrada: path (cadena)
  • Crea directorios principales si es necesario
  • Tiene éxito silenciosamente si el directorio existe
• directorio_de_lista
  • Listar el contenido del directorio con prefijos [FILE] o [DIR]
  • Entrada: path (cadena)
• mover_archivo
  • Mover o renombrar archivos y directorios
  • Entradas:
    • source (cadena)
    • destination (cadena)
  • Falla si el destino existe
• archivos de búsqueda
  • Buscar archivos/directorios de forma recursiva
  • Entradas:
    • path (cadena): Directorio de inicio
    • pattern (cadena): Buscar patrón
    • excludePatterns (string[]): Excluye cualquier patrón. Se admiten formatos glob.
  • Coincidencia sin distinción entre mayúsculas y minúsculas
  • Devuelve rutas completas a las coincidencias
• obtener_información_del_archivo
  • Obtener metadatos detallados de archivos/directorios
  • Entrada: path (cadena)
  • Devoluciones:
    • Tamaño
    • Tiempo de creación
    • Hora modificada
    • Tiempo de acceso
    • Tipo (archivo/directorio)
    • Permisos
• lista_de_directorios_permitidos
  • Enumere todos los directorios a los que el servidor tiene permiso de acceder
  • No se requiere entrada
  • Devoluciones:
    • Directorios desde los que este servidor puede leer/escribir

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json :

Nota: Puede proporcionar directorios aislados al servidor montándolos en /projects . Al agregar el indicador ro , el servidor podrá leer el directorio solo.

Estibador

Nota: todos los directorios deben montarse en /projects de forma predeterminada.

NPX

Uso con VS Code

Para una instalación rápida, haga clic en los botones de instalación a continuación...

Para la instalación manual, agregue el siguiente bloque JSON a su archivo de configuración de usuario (JSON) en VS Code. Para ello, presione Ctrl + Shift + P y escriba Preferences: Open Settings (JSON) .

Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otros.

Tenga en cuenta que la clave mcp no es necesaria en el archivo .vscode/mcp.json .

Puedes proporcionar directorios aislados al servidor montándolos en /projects . Al añadir el indicador ro , el servidor podrá leer el directorio solo.

Estibador

Nota: todos los directorios deben montarse en /projects de forma predeterminada.

NPX

Construir

Compilación de Docker:

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.