uns-mcp-server/CLAUDE_DESKTOP_SETUP.md

Pure JavaScript MCP server for Unstructured.io - No Python required!

# Claude Desktop MCP Configuration

## ✅ Configuration Updated

Your Claude Desktop is now configured to use the **npx version** of the Unstructured MCP server from npm!

### Current Configuration:
```json
"uns-mcp": {
  "command": "npx",
  "args": [
    "-y",
    "uns-mcp-server@latest"
  ],
  "env": {
    "UNSTRUCTURED_API_KEY": "FG7oVSlRcKX4jp6LOmWRT5TvTNRdFJ",
    "LOG_LEVEL": "ERROR"
  }
}
```

### What Changed:
- ❌ **OLD**: Local file reference (`node /Users/.../mcp-server-fixed.js`)
- ✅ **NEW**: NPX from npm registry (`npx uns-mcp-server@latest`)

### Benefits:
1. **Auto-updates**: Always uses the latest version
2. **No local files**: Downloads from npm as needed
3. **Clean setup**: No need to maintain local installation
4. **Portable**: Works on any machine with npm

## Usage in Claude Desktop

After restarting Claude Desktop, you can use these tools:

### Document Processing
- `process_document` - Process any document with OCR
- `extract_text` - Extract plain text
- `extract_tables` - Extract tables as JSON/CSV/HTML

### Example Commands:
```javascript
// Process a PDF
await process_document({
  file_path: "/path/to/document.pdf",
  strategy: "hi_res",
  ocr_enabled: true
})

// Extract text
await extract_text({
  file_path: "/path/to/document.pdf"
})

// Extract tables
await extract_tables({
  file_path: "/path/to/spreadsheet.xlsx",
  format: "csv"
})
```

## Restart Required

**Important**: Restart Claude Desktop to activate the new configuration:
1. Quit Claude Desktop completely
2. Relaunch Claude Desktop
3. The MCP server will auto-download from npm on first use

## Version Information

- **NPM Package**: uns-mcp-server@2.0.1
- **GitHub**: https://github.com/CG-Labs/Unstructured-Document-Processor-MCP
- **Pure JavaScript**: No Python required!
- **Auto-updates**: Using `@latest` tag

## Troubleshooting

If the server doesn't connect after restart:

1. Check the MCP status with `/mcp` command
2. Verify API key is correct
3. Check npm/npx is installed: `which npx`
4. Try manual test: `UNSTRUCTURED_API_KEY=your_key npx uns-mcp-server@latest`

---

Configuration updated: August 28, 2025