A
securityA
licenseA
qualityMCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more.
Last updated -
22,573
69,779
MIT License
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
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A secure MCP server enabling read-only access and file search capabilities within a specified directory, while respecting .gitignore patterns.
Related Resources
Related MCP Servers
- -securityAlicense-qualityThis 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.Last updated -21MIT License
- AsecurityAlicenseAqualityAn 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 -16MIT License
- AsecurityFlicenseAqualityAn 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 -9132