mcp filesystem python

Local 2025-08-31 23:30:03 0
Developer Tools @mtunell/mcp-filesystem-python

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

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%Claudeclaude_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