MCP File System Server

Servidor del sistema de archivos MCP

Servidor MCP que proporciona operaciones del sistema de archivos. Admite navegación, lectura, escritura, análisis de archivos y ejecución de comandos.

Herramientas

Operaciones de archivos y directorios

• ls(path) - Lista el contenido del directorio
• cd(path) - Cambia el directorio de trabajo (admite la expansión del directorio de inicio con ~)
• read_file(path) - Leer el contenido del archivo
• write_file(path, content) - Escribe contenido en un archivo
• mkdir(path) - Crear directorio
• rm(path) - Eliminar archivo o directorio vacío
• rmdir(path) - Elimina el directorio y el contenido de forma recursiva
• cp(src, dst) - Copiar archivo o directorio
• mv(src, dst) - Mover archivo o directorio

Edición y búsqueda

• edit_file(path, changes) : aplica múltiples operaciones de búsqueda y reemplazo a un archivo, donde changes es una lista de tuplas (texto_de_búsqueda, texto_de_reemplazo)
• grep(pattern, path) : busca un patrón de expresión regular en los archivos

Análisis

• summary(path) - Genera un resumen de archivos Python (.py) y Markdown (.md):
  • Python: Listas de funciones y clases
  • Markdown: enumera encabezados (líneas que comienzan con #)

Operaciones por lotes

• read_files(paths) : lee varios archivos y devuelve un diccionario que asigna rutas a los contenidos.
• summarize(paths) : genera resúmenes para varios archivos y devuelve un diccionario que asigna rutas a los resúmenes.

Navegación del proyecto

• work_on(path) : Cambia al directorio, lista su contenido y obtiene las notas de CLAUDE.md. Útil para familiarizarse con un proyecto al inicio de una conversación.

Calidad del código

• ruff_check(paths) - Ejecuta ruff linter en archivos especificados
• ruff_format(paths) - Formatear archivos usando ruff

Ejecución de comandos

• shell_command(command, args=None, cmdline=None, timeout=30) - Ejecuta comandos de shell y captura su salida

  ⚠️ Advertencia de seguridad : Esta herramienta permite la ejecución de comandos arbitrarios en el sistema host. Siempre inspeccione y valide los comandos antes de permitir su ejecución, especialmente si la fuente de entrada no es confiable.