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:
- Replace the paths with your actual paths
- Use forward slashes (`/`) for macOS/Linux and backslashes (`\\`) for Windows
- Use absolute paths (not relative paths)
Development
- Clone the repository
- Create virtual environment and sync requirements,
uv sync
License
MIT
