MCP Filesystem Python

MIT License

Overview Schema Related Servers Reviews Score

Need Help?View Source Code Report Issue

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

-

security - not tested

A

license - permissive license (MIT License)

-

quality - not tested

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