- docs/GIORDANO-FIX.md: step-by-step for next session with Giordano - docs/INSTALL-WINDOWS.md: complete clean install guide for any Windows machine
3 KiB
3 KiB
Giordano Desktop Fix — Next Session
Date: 2026-08-03
Machine: Windows, AMD Ryzen 3 2200G, 8GB RAM, user giord, Python 3.14
Issue: Claude Desktop MCP connector fails — wrong MCP package version installed
Prerequisites
- Diligence app folder at
C:\Users\giord\Downloads\Diligence-main - Claude Desktop installed (Microsoft Store version)
- Node.js installed
mcp_stdio.pyalready in the Diligence-main folder- Claude Desktop config already set at both paths:
%APPDATA%\Claude\claude_desktop_config.json%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
Step 1 — Clean up old MCP packages
cd "$env:USERPROFILE\Downloads\Diligence-main"
pip uninstall mcp mcp-cli fastmcp -y
Step 2 — Fix the import in server.py
The old code imports from the wrong package. Run this once:
(Get-Content diligence\mcp\server.py) -replace 'from mcp\.server\.fastmcp import FastMCP', 'from fastmcp import FastMCP' | Set-Content diligence\mcp\server.py
Step 3 — Install the correct packages
pip install "fastmcp>=3.0.0"
pip install tzdata
Step 4 — Test the MCP stdio script
python mcp_stdio.py
- If it hangs with no output → success. Ctrl+C to stop.
- If it throws an error → paste the traceback.
Step 5 — Start Diligence
python -m diligence
Confirm both lines appear:
Diligence running at http://localhost:8000MCP: http://localhost:3001/sse
Step 6 — Restart Claude Desktop
Get-Process *claude* | Stop-Process -Force
Reopen Claude Desktop from the Start menu. Look for a tools/hammer icon indicating MCP connected.
Step 7 — Test
In Claude Desktop, type:
What's my fitness status today?
Claude should call the get_context tool and return fitness data.
Also test a write operation:
Log a 30 minute workout called Morning Run
Fallback: Built-in AI Coach (no Claude Desktop needed)
If Claude Desktop MCP continues to have issues, use the built-in coach:
- Go to
http://localhost:8000/agentin the browser - Under "Option 1 — Built-in AI Coach", click Get key next to OpenRouter
- Sign up with Google (free, 26 free models available)
- Copy the API key
- In Diligence, go to Settings > Integrations > AI Coaching
- Paste the key and select a model
- Use the Coach tab in the bottom nav
This runs entirely inside the app — no external tools needed.
Known Issues on This Machine
| Issue | Fix | Status |
|---|---|---|
| tzdata not in pip dependencies | pip install tzdata manually | Pending GitHub push |
| mcp v2.0.0 removed FastMCP import | Switch to standalone fastmcp package | Fixed in subo repo, pending GitHub |
| GitHub push token expired | Need new PAT with repo scope | Not yet done |
| Migration warning: NOT NULL on point_rules.description | Non-fatal, cosmetic | Low priority |
| PowerShell QuickEdit mode pauses the app | Right-click title bar, Properties, uncheck QuickEdit | Told user |