Metadata-Version: 2.4
Name: gwf-mcp
Version: 1.1.6
Summary: GWF Workspace MCP server for Claude Desktop — folder-scoped document tools
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]>=1.9.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: pdfplumber>=0.11.0
Requires-Dist: python-docx>=1.1.2
Requires-Dist: pypdf>=5.0.0
Requires-Dist: pymupdf>=1.24.0
Requires-Dist: python-pptx>=1.0.0

# gwf-mcp

Same package for **Windows and Mac**. Use the install + path style for each OS.

## Install

### Windows
```bash
pip install -U gwf-mcp
```

### Mac (Homebrew Python)
```bash
brew install pipx
pipx ensurepath
pipx install gwf-mcp
# upgrade: pipx upgrade gwf-mcp
```

Or Mac venv:
```bash
python3 -m venv ~/gwf-mcp-venv
source ~/gwf-mcp-venv/bin/activate
pip install -U gwf-mcp
```

## Claude Desktop config

### Windows
```json
{
  "mcpServers": {
    "gwf-workspace": {
      "command": "python",
      "args": ["-m", "gwf_mcp"],
      "env": {
        "GWF_WORKSPACE_ROOT": "C:\\Users\\You\\Desktop\\accounting"
      }
    }
  }
}
```

### Mac
```json
{
  "mcpServers": {
    "gwf-workspace": {
      "command": "gwf-mcp",
      "args": [],
      "env": {
        "GWF_WORKSPACE_ROOT": "/Users/You/Desktop/accounting"
      }
    }
  }
}
```

Mac venv alternative: `command` = `/Users/You/gwf-mcp-venv/bin/python`, `args` = `["-m", "gwf_mcp"]`.

Quit Claude fully → reopen after config changes.

## Usage (both OS)
- `list_files` → list (including nested folders)
- `list_files(read="file.docx")` → read
- `get_workspace` → show configured folder

## Mac “no files” checklist
1. Path is Mac style (`/Users/...`), not `C:\\...`
2. Folder exists and has pdf/docx/xlsx/pptx
3. Full Disk Access for Claude (System Settings → Privacy & Security)
4. `get_workspace` then `list_files`
