Filesystem MCP Server

Servidor MCP de Sistema de Archivos

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona operaciones de sistema de archivos para Claude AI.

Características

Este servidor MCP proporciona las siguientes operaciones de sistema de archivos:

1. read_file: Leer el contenido completo de un archivo

   • Entrada: path (cadena)
   • Lee el contenido completo del archivo con codificación UTF-8

2. read_multiple_files: Leer múltiples archivos simultáneamente

   • Entrada: paths (cadena[])
   • Las lecturas fallidas no detendrán toda la operación

3. write_file: Crear un archivo nuevo o sobrescribir uno existente

   • Entradas:
     • path (cadena): Ubicación del archivo
     • content (cadena): Contenido del archivo

4. create_directory: Crear un directorio nuevo o asegurar que exista

   • Entrada: path (cadena)
   • Crea directorios padre si es necesario
   • Se completa silenciosamente si el directorio ya existe

5. list_directory: Listar el contenido del directorio con prefijos [FILE] o [DIR]

   • Entrada: path (cadena)

6. move_file: Mover o renombrar archivos y directorios

   • Entradas:
     • source (cadena)
     • destination (cadena)
   • Falla si el destino ya existe

7. search_files: Buscar archivos/directorios de forma recursiva

   • Entradas:
     • path (cadena): Directorio de inicio
     • pattern (cadena): Patrón de búsqueda
   • Coincidencia sin distinción de mayúsculas y minúsculas
   • Devuelve rutas completas de las coincidencias

8. get_file_info: Obtener metadatos detallados de archivos/directorios

   • Entrada: path (cadena)
   • Devuelve:
     • Tamaño
     • Hora de creación
     • Hora de modificación
     • Hora de acceso
     • Tipo (archivo/directorio)
     • Permisos

9. list_allowed_directories: Listar todos los directorios a los que el servidor tiene permitido acceder

   • No requiere entrada
   • Devuelve los directorios desde los que este servidor puede leer/escribir

Seguridad

El servidor solo permite operaciones dentro de directorios especificados mediante argumentos de línea de comandos.

Instalación

1. Clonar este repositorio
2. Instalar dependencias: npm install
3. Compilar el proyecto: npm run build

Uso

Ejecute el servidor con uno o más directorios permitidos:

node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2

Configuración de MCP

Agregue el servidor a su archivo de configuración de MCP:

{
  "mcpServers": {
    "filesystem-server": {
      "command": "node",
      "args": [
        "/path/to/filesystem-server/build/index.js",
        "/path/to/allowed/dir1",
        "/path/to/allowed/dir2"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Licencia

ISC