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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

This 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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Filesystem Python
mtunell
-
security
A
license
-
quality
A secure MCP server enabling read-only access and file search capabilities within a specified directory, while respecting .gitignore patterns.
Last updated -
Python
MIT License
Project Content Server
MaheshDoiphode
A
security
A
license
A
quality
An 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 -
1
4
TypeScript
MIT License
MCP Git Repo Browser
razorback16
A
security
A
license
A
quality
A Node.js server that allows browsing Git repositories through MCP, providing tools to view directory structures and read important files from repositories.
Last updated -
2
JavaScript
MIT License
Filesystem MCP Server
ai-yliu
-
security
F
license
-
quality
An 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 -
5
1
JavaScript

View all related MCP servers

MCP Filesystem Python