Mcp Filesystem Python
What is Mcp Filesystem Python
mcp-filesystem-python is a Model Context Protocol (MCP) server that provides secure, read-only access to files in a specified directory, primarily developed by Claude.
Use cases
Use cases include providing secure file access for applications, integrating with Claude Desktop for file management, and enabling file search functionalities in various software solutions.
How to use
To use mcp-filesystem-python, install it using the command ‘uv add mcp-filesystem-python’, then run the server with ‘uv run src/filesystem/server.py /path/to/directory’.
Key features
Key features include exposing files as MCP resources via ‘file://’ URI scheme, file search capabilities, respect for .gitignore patterns, path traversal protection, and MIME type detection.
Where to use
mcp-filesystem-python can be used in environments where secure file access is required, such as cloud applications, development environments, and desktop applications integrated with Claude.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Mcp Filesystem Python
mcp-filesystem-python is a Model Context Protocol (MCP) server that provides secure, read-only access to files in a specified directory, primarily developed by Claude.
Use cases
Use cases include providing secure file access for applications, integrating with Claude Desktop for file management, and enabling file search functionalities in various software solutions.
How to use
To use mcp-filesystem-python, install it using the command ‘uv add mcp-filesystem-python’, then run the server with ‘uv run src/filesystem/server.py /path/to/directory’.
Key features
Key features include exposing files as MCP resources via ‘file://’ URI scheme, file search capabilities, respect for .gitignore patterns, path traversal protection, and MIME type detection.
Where to use
mcp-filesystem-python can be used in environments where secure file access is required, such as cloud applications, development environments, and desktop applications integrated with Claude.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
