MCP Filesystem Python

by punkpeye
Verified
MIT License
6
  • Apple
  • Linux

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports configuration for Claude Desktop on Linux systems with specific configuration file paths

  • Supports configuration for Claude Desktop on macOS systems with specific configuration file paths

Sistema de archivos MCP Python

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona acceso seguro y de solo lectura a los archivos en un directorio específico.

Características

  • Expone archivos como recursos MCP utilizando el esquema URI `file://`
  • Proporciona capacidades de búsqueda de archivos a través de herramientas MCP
  • Respeta los patrones .gitignore
  • Funciones de seguridad que incluyen protección contra cruce de ruta
  • Detección de tipo MIME

Instalación

Usando UV:

uv add mcp-filesystem-python

Uso

Ejecutar el servidor:

uv run src/filesystem/server.py /path/to/directory

Integración de escritorio de Claude

Ejemplos de configuración

Se pueden encontrar configuraciones de ejemplo para Claude Desktop en el directorio `examples`:

  • `examples/claude_desktop_config.json`: Ejemplo para macOS/Linux
  • `examples/claude_desktop_config_windows.json`: Ejemplo para Windows

Estos archivos deben ubicarse en:

  • macOS: `~/Biblioteca/Soporte de aplicaciones/Claude/claude_desktop_config.json`
  • Ventanas: `%AppData%\Claude\claude_desktop_config.json`

Asegúrese de:

  1. Reemplace las rutas con sus rutas reales
  2. Utilice barras diagonales (`/`) para macOS/Linux y barras diagonales invertidas (`\\`) para Windows
  3. Utilice rutas absolutas (no relativas)

Desarrollo

  1. Clonar el repositorio
  2. Crear entorno virtual y sincronizar requisitos, uv sync

Licencia

Instituto Tecnológico de Massachusetts (MIT)

-
security - not tested
A
license - permissive license
-
quality - not tested

Este servidor ofrece acceso seguro y de sólo lectura a archivos de directorio a través del MCP, admite búsqueda de archivos, cumplimiento de .gitignore, protección de recorrido de ruta y detección de tipo MIME utilizando el esquema de URI 'file://'.

  1. Features
    1. Installation
      1. Usage
        1. Claude Desktop Integration
          1. Configuration Examples
        2. Development
          1. License
            ID: pjawwhnuzf