MCP Filesystem Python

by mtunell

MCP Filesystem Python

A Model Context Protocol (MCP) server that provides secure, read-only access to files in a specified directory.

Features

  • Exposes files as MCP resources using `file://` URI scheme
  • Provides file search capabilities through MCP tools
  • Respects .gitignore patterns
  • Security features including path traversal protection
  • MIME type detection

Installation

Using UV:

uv add mcp-filesystem-python

Usage

Run the server:

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

Claude Desktop Integration

Configuration Examples

Example configurations for Claude Desktop can be found in the `examples` directory:

  • `examples/claude_desktop_config.json`: Example for macOS/Linux
  • `examples/claude_desktop_config_windows.json`: Example for Windows

These files should be placed at:

  • macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  • Windows: `%AppData%\Claude\claude_desktop_config.json`

Make sure to:

  1. Replace the paths with your actual paths
  2. Use forward slashes (`/`) for macOS/Linux and backslashes (`\\`) for Windows
  3. Use absolute paths (not relative paths)

Development

  1. Clone the repository
  2. Create virtual environment and sync requirements, uv sync

License

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.

A secure MCP server enabling read-only access and file search capabilities within a specified directory, while respecting .gitignore patterns.

  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
              22,912
              43,961
              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