Metadata-Version: 2.4
Name: gwf-mcp
Version: 1.0.1
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

Installable MCP server for Claude Desktop. Other developers do **not** need the GWF app codebase.

## Install

```bash
pip install gwf-mcp
# upgrade: pip install -U gwf-mcp
```

## Claude Desktop config

Put the folder path in config so `list_files` works with no extra setup:

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

Fully quit and reopen Claude Desktop. Then say: `list_files`

## How it connects

Claude Desktop starts `python -m gwf_mcp` **locally** and talks over **stdio** (no host, no port).

The Electron app uses HTTP on `127.0.0.1:8005` — that is separate from Claude Desktop.

## Tools

- `list_files` / `get_document` — use the folder from `GWF_WORKSPACE_ROOT`
- `set_workspace` / `get_workspace` — optional, to change folder in chat
- Allowed: `.pdf` `.doc` `.docx` `.xls` `.xlsx` `.ppt` `.pptx`
