Skip to main content
Glama
Sign In
MCP Filesystem Python

MCP Filesystem Python

by gary109
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

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…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    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.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-file-lens

      solatis
      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

    • mcp-readonly-code-server

      John0615
      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

    • DocFS

      feli0x
      A
      license
      A
      quality
      Not graded
      maintenance
      Read-only filesystem MCP server with .gitignore filtering, multi-root support, and cache for efficient file exploration.
      4
      8 npm
      MIT