Skip to main content
Glama
Grim-235

Native MCP Filesystem Workspace for Claude

by Grim-235

๏ปฟ# Native MCP Filesystem Workspace for Claude

A robust, production-ready local filesystem workspace for Claude Desktop using the Model Context Protocol (MCP) on Windows.

๐Ÿš€ Features

  • Direct Node.js Execution: Eliminates Windows npx ENOENT / .cmd spawn bugs by running through the native node.exe binary.

  • Structured Workspace: Prevents "junk drawer" clutter with clear dedicated directories (inbox, projects, notes, archive).

  • Built-in Undo / Version Control: Git initialized with .gitignore so every AI modification can be diffed and rolled back with git diff or git restore.

  • Full Read & Write: Enables read_text_file, write_file, edit_file, create_directory, and directory tree listing within D:\MCP.

  • Strict Security Guardrail: Enforces strict path validationโ€”Claude cannot access files outside this workspace.


Related MCP server: Windows File Tools MCP Server

๐Ÿ“ Workspace Structure

D:\MCP\
โ”œโ”€โ”€ inbox/       # Drop raw files, PDFs, or CSVs here for Claude to process
โ”œโ”€โ”€ projects/    # Active projects and codebases (one subfolder per project)
โ”œโ”€โ”€ notes/       # Scratchpad, research notes, meeting logs, summaries
โ”œโ”€โ”€ archive/     # Completed work and historical records
โ”œโ”€โ”€ .gitignore   # Excludes node_modules and npm lockfiles
โ””โ”€โ”€ package.json # Manages the local MCP filesystem server

๐Ÿ› ๏ธ Setup & Configuration

1. Install Dependencies

cd D:\MCP
npm install

2. Configure Claude Desktop

Add the following to your Claude Desktop configuration file (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "filesystem": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "D:\\MCP\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
        "D:\\MCP"
      ]
    }
  }
}

3. Restart Claude Desktop

Fully exit Claude Desktop from the Windows System Tray and re-open it. Look for the hammer icon in the chat box.


๐Ÿ›ก๏ธ Git Safety Net Commands

# See what Claude just edited:
git diff

# Keep Claude's changes:
git add . && git commit -m "Claude update"

# Undo all Claude's changes if it made a mistake:
git restore .

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables safe file system operations including reading, writing, updating, and deleting files with built-in security safeguards, automatic backups, and comprehensive error handling. Provides directory listing, file metadata extraction, and protects against operations on system-critical paths.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides secure file read, write, and edit operations for Windows, with enterprise-grade features like atomic writes, file locking, and path validation.
    -
  • A
    license
    A
    quality
    A
    maintenance
    Enables AI clients to inspect and carefully edit a bounded local workspace via stdio, with a read-only default, conflict-safe updates, and no network listener or telemetry.
    9
    Apache 2.0
  • A
    license
    A
    quality
    C
    maintenance
    Enables safe filesystem and git operations confined within a single allowed directory tree, using symlink-resolved path containment to protect against path traversal. Users can read, write, list, and search files, as well as initialize repos and run status, stage, commit, diff, and log operations through MCP.
    11
    MIT