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

---

## 📁 Workspace Structure

```text
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
```powershell
cd D:\MCP
npm install
```

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

```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

```powershell
# 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 .
```