Skip to main content
Glama
MCP Filesystem Python

MCP Filesystem Python

by gary109

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

Related MCP server: mcp-file-lens

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:

  1. Replace the paths with your actual paths

  2. Use forward slashes (`/`) for macOS/Linux and backslashes (`\\`) for Windows

  3. Use absolute paths (not relative paths)

Development

  1. Clone the repository

  2. Create virtual environment and sync requirements, uv sync

License

MIT

Available Tools

3 tools
delete-fileB

Delete a file or directory

Inputs: path (required), recursive.

search-filesA

Search for files containing specific text

Inputs: query (required), file_pattern.

write-fileB

Write content to a file

Inputs: path (required), content (required), create_dirs.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: deleting, searching, and writing files. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb-noun pattern with hyphens (e.g., delete-file, search-files). No mixing of conventions.

    Tool Count3/5

    With only 3 tools, the server is on the lower end of the ideal range. While each tool is distinct, the count feels thin for a filesystem server.

    Completeness2/5

    Fundamental operations like reading file content or listing directories are missing. Agents cannot perform basic file access, leading to significant gaps.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides a flexible lens into directory structures and files, enabling LLM clients to efficiently navigate and understand codebases with minimal noise. It offers secure, gitignore-aware file access with tools like directory listing, file reading, and grep-like search.
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A read-only MCP server that exposes a local code workspace to AI clients via stdio, providing file browsing and text search capabilities with path safety rules.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Read-only filesystem MCP server with .gitignore filtering, multi-root support, and cache for efficient file exploration.
      4
      7 npm
      MIT