MCP Filesystem Python

by mtunell

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

local-only server

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

Un servidor MCP seguro que permite acceso de solo lectura y capacidades de búsqueda de archivos dentro de un directorio específico, respetando al mismo tiempo los patrones .gitignore.

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

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              MCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more.
              Last updated -
              17
              36,796
              42,793
              JavaScript
              MIT License
            • -
              security
              A
              license
              -
              quality
              This server offers secure, read-only access to directory files via the MCP, supporting file searching, .gitignore compliance, path traversal protection, and MIME type detection using the 'file://' URI scheme.
              Last updated -
              6
              MIT License
              • Apple
              • Linux
            • A
              security
              A
              license
              A
              quality
              An MCP server that provides access to project files and their contents, allowing users to retrieve file data from specified project directories with error handling and configuration options.
              Last updated -
              1
              4
              TypeScript
              MIT License
            • -
              security
              F
              license
              -
              quality
              An MCP server that allows Claude AI to perform filesystem operations including reading, writing, listing, moving files, and searching directories within specified allowed paths.
              Last updated -
              5
              1
              JavaScript

            View all related MCP servers

            ID: admt9a4f34