MCP Filesystem Python

MIT License
6
  • Apple
  • Linux

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

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.

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.

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

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              A secure MCP server enabling read-only access and file search capabilities within a specified directory, while respecting .gitignore patterns.
              Last updated -
              Python
              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
            • A
              security
              A
              license
              A
              quality
              A Node.js server that allows browsing Git repositories through MCP, providing tools to view directory structures and read important files from repositories.
              Last updated -
              2
              JavaScript
              MIT License
              • Linux
              • Apple
            • -
              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: pjawwhnuzf