mcp-server-filesystem

Servidor MCP que expone operaciones del sistema de archivos Linux como herramientas para agentes LLM, construido con FastMCP. Diseñado como un servidor de pruebas ligero y de pocas dependencias para la herramienta de proxy/catálogo MCP mcprack.

Configuración

No se necesitan credenciales. Toda la configuración se realiza mediante variables de entorno, leídas una vez al inicio:

Todas las rutas proporcionadas a las herramientas se resuelven contra FS_ROOT y se rechazan si intentaran escapar de él (mediante .. o un enlace simbólico). Se trata de un límite a nivel de aplicación, no de una sandbox reforzada (sin chroot/namespace de montaje).

Related MCP server: ab_mcp

Herramientas

Solo lectura: list_dir, read_file, stat, exists, glob_search.

Modificación (requieren FS_READONLY=false): write_file, mkdir, delete, move, copy.

Uso

Recomendado — paquete Debian del repositorio VitexSoftware

sudo curl -fsSL http://repo.vitexsoftware.com/KEY.gpg -o /usr/share/keyrings/vitexsoftware-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/vitexsoftware-archive-keyring.gpg] http://repo.vitexsoftware.com trixie main backports" \
  | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
sudo apt update
sudo apt install mcp-server-filesystem

El componente backports es obligatorio, no opcional: python3-mcp (una dependencia de python3-fastmcp) necesita python3-jsonschema >= 4.20.0, que es más reciente que la versión que Debian trixie incluye en main — solo está disponible en backports. Sin él, apt install falla con un error de dependencia no satisfecha en python3-jsonschema.

Esto instala python3-fastmcp y mcp-server-filesystem en un solo paso.

Alternativa — pip

pip install -e .
export FS_ROOT=/path/to/sandbox
mcp-server-filesystem

Integración con mcprack

Registra este servidor en mcprack con:

• Comando: mcp-server-filesystem

• Entorno: FS_ROOT=/path/to/sandbox, FS_READONLY=false (si se necesitan escrituras)

mcprack lo lanza como subproceso stdio y lo sirve como proxy sobre HTTP por usuario.

Desarrollo

pytest