54 lines
1.5 KiB
Markdown
54 lines
1.5 KiB
Markdown
|
# Handoff Pro — Construction Project Management MCP Server
|
||
|
|
|
||
|
|
MCP server extending Tom (Kellow Construction AI agent on GW-2) with estimation, proposals, invoicing, and project management — synced with JobTread + QuickBooks Online.
|
||
|
|
|
||
|
|
## Architecture
|
||
|
|
|
||
|
|
```
|
||
|
|
Tom (Telegram) → mcporter → handoff-pro MCP (port 3101)
|
||
|
|
→ design-agent MCP (port 3100)
|
||
|
|
↓
|
||
|
|
SQLite (local) ←→ JobTread API
|
||
|
|
←→ QuickBooks Online API
|
||
|
|
```
|
||
|
|
|
||
|
|
## Quick Start
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Run tests
|
||
|
|
cd handoff-pro && python3 -m pytest tests/
|
||
|
|
|
||
|
|
# Run server locally
|
||
|
|
python3 server.py
|
||
|
|
|
||
|
|
# Deploy to GW-2
|
||
|
|
chmod +x deploy.sh && ./deploy.sh
|
||
|
|
|
||
|
|
# Or run as Docker container
|
||
|
|
docker build -t handoff-pro .
|
||
|
|
docker run -d --name handoff-pro -p 3101:3101 \
|
||
|
|
-v /path/to/.jobtread-api.json:/app/data/.jobtread-api.json:ro \
|
||
|
|
handoff-pro
|
||
|
|
```
|
||
|
|
|
||
|
|
## Tools (34 total)
|
||
|
|
|
||
|
|
See `SKILL.md` for full tool reference and workflow patterns.
|
||
|
|
|
||
|
|
## Dependencies
|
||
|
|
|
||
|
|
- Python 3.10+ (stdlib only — no pip install needed)
|
||
|
|
- SQLite3 (bundled with Python)
|
||
|
|
- Network access to JobTread API and QBO token server
|
||
|
|
|
||
|
|
## Deployment Options
|
||
|
|
|
||
|
|
1. **In-container** (recommended): Deploy scripts directly into Tom's workspace via `deploy.sh`
|
||
|
|
2. **Standalone Docker**: Run as separate container on TrueNAS, register in mcporter
|
||
|
|
3. **Hybrid**: Scripts in workspace + server as sidecar container
|
||
|
|
|
||
|
|
## Credentials
|
||
|
|
|
||
|
|
- **JobTread**: `.jobtread-api.json` with `grantKey` and `organizationId`
|
||
|
|
- **QBO**: Token server at `http://192.168.86.11:18801/kellow-tokens.json`
|