wpir-mcp
by chkania
README.md
# wpir-mcp
MCP-Server mit **Förderprogrammen und gesetzlichen Regelungen** rund um den Umstieg von Gas oder Öl auf eine Wärmepumpe (KfW 458, KfW 358/359, § 35c EStG, Darlehensrecht), jeweils mit Quelle, Prüfdatum und Status. Er ist die Wissensbasis, gegen die der [Wärmepumpen-Investitionsrechner](https://github.com/chkania/wpir) seine Standardwerte auf Aktualität prüfen lässt.
Öffentlich, nur lesend, zustandslos; keine Anmeldung, keine Nutzerdaten. Keine Rechts- oder Förderberatung – maßgeblich sind die verlinkten Originalquellen.
## Werkzeuge
| Werkzeug | Zweck |
|---|---|
| `list_topics` | Themen mit Anzahl der Fakten und ältestem Prüfdatum |
| `get_facts` | Fakten nach Thema, ID, Freitext oder Feldpfad des Rechners |
| `list_sources` | alle Quellen einmal, mit den Fakten, die sie belegen |
| `list_keys` | Feldpfade des Rechners, für die es einen Referenzwert gibt |
| `check_value` | Wert des Rechners (`key`, `value`) gegen den Referenzwert prüfen: `gleich`, `abweichend`, `unbekannt` |
Prozentwerte sind Anteile (0,3 = 30 %), Monate „JJJJ-MM“. Beispiel:
```json
{ "name": "check_value", "arguments": { "key": "funding.grundRate", "value": 0.25 } }
```
## Verbinden (Claude Code)
```bash
claude mcp add --transport http wpir-mcp https://mcp.wpir.de/mcp
```
Im Repo `wpir` steht die Verbindung in `.mcp.json`.
## Lokal entwickeln
```bash
npm install
npm test # Tests (Datenqualität, Abfragen, SDK-Client, HTTP-Endpunkt)
npm run typecheck
npm run dev # http://localhost:3000/mcp
```
## Bereitstellen bei Vercel
1. In Vercel **Add New → Project** und das Repo `chkania/wpir-mcp` importieren (Framework „Other“, keine Build- oder Output-Einstellungen nötig, keine Umgebungsvariablen).
2. Vercel erkennt `api/mcp.ts` als Funktion; `vercel.json` leitet `/mcp` dorthin.
3. Nach dem Deployment prüfen: `curl -s -X POST https://mcp.wpir.de/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'`.
4. Die Domain `mcp.wpir.de` bei Vercel dem Projekt zuordnen (Settings → Domains, CNAME-Eintrag bei der Domain). Die URL steht in `.mcp.json` des Repos `wpir`; der Alias `wpir-mcp.vercel.app` funktioniert ebenfalls.
## Daten pflegen
Die Wissensbasis liegt unter `src/data/` (eine Datei je Thema). Jeder Fakt braucht Quelle, Prüfdatum und Status; siehe [CLAUDE.md](CLAUDE.md). Anforderungen: [docs/anforderungen/](docs/anforderungen/README.md). Mitarbeit: [CONTRIBUTING.md](CONTRIBUTING.md).
## Lizenz
PolyForm Noncommercial 1.0.0, siehe [LICENSE.md](LICENSE.md).
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues