npm install @sanierungskompass/kfw-mcp

git clone https://github.com/timfellendorf/kfw-mcp.git
cd kfw-mcp
npm install
npm run build

npm start
# oder für Entwicklung:
npm run dev

{
  "mcpServers": {
    "kfw-foerdermittel": {
      "command": "node",
      "args": ["/pfad/zu/kfw-mcp/dist/index.js"]
    }
  }
}

# Server im Hintergrund starten
npm run dev &

# In Claude Code verwenden:
# - Claude erkennt verfügbare Tools automatisch
# - Tools können direkt in Prompts genutzt werden

Claude: "Zeige mir alle verfügbaren KfW-Programme"

Server antwortet mit:
[
  {
    "id": "358",
    "name": "KfW 358 - Ergänzungskredit für Einzelmaßnahmen",
    "type": "Kredit",
    "category": "BEG - Einzelmaßnahmen",
    "description": "Zinsgünstiger Kredit für einzelne energetische Maßnahmen an Wohngebäuden",
    "maxLoanAmount": 120000,
    "interestRate": {
      "current": 2.75,
      "unit": "% p.a. effektiv"
    }
  },
  ...
]

Claude: "Gib mir Details zum KfW 358 Programm"

Server antwortet mit:
{
  "id": "358",
  "name": "KfW 358 - Ergänzungskredit für Einzelmaßnahmen",
  "type": "Kredit",
  "description": "Zinsgünstiger Kredit für einzelne energetische Maßnahmen an Wohngebäuden",
  "maxLoanAmount": 120000,
  "eligibleMeasures": [
    "Fenstertausch",
    "Türentausch",
    "Dachdämmung",
    "Wanddämmung",
    "Kellerdeckendämmung",
    "Heizungsanlage",
    "Lüftungsanlage",
    "Solarthermieanlage"
  ],
  "interestRate": {
    "current": 2.75,
    "unit": "% p.a. effektiv"
  },
  "maxRepaymentPeriod": 20,
  "minRepaymentPeriod": 4,
  "tilgungszuschuss": 0,
  "notes": "Für einzelne energetische Sanierungsmaßnahmen"
}

Claude: "Welche KfW-Programme gibt es für Wärmepumpen?"

Server antwortet mit:
{
  "measure": "Wärmepumpe",
  "applicablePrograms": [
    {
      "id": "458",
      "name": "KfW 458 - Heizungsförderung",
      "type": "Zuschuss",
      "eligibilityNotes": "30% Basis + bis zu 40% Bonuszuschläge = max 70%"
    },
    {
      "id": "359",
      "name": "KfW 359 - Kredit für Sanierungsmaßnahmen",
      "type": "Kredit",
      "eligibilityNotes": "Umfassende Sanierung mit Effizienzhaus-Standard"
    }
  ],
  "matchCount": 2,
  "recommendations": [
    "Zuschuss- und Kreditprogramme verfügbar - vergleichen Sie die Konditionen.",
    "Zuschuss-Programme erfordern keine Rückzahlung.",
    "Kredit-Programme bieten zinsgünstige Darlehen."
  ]
}

Claude: "Berechne die monatliche Rate für einen 50.000€ Kredit im KfW 358 über 15 Jahre"

Server antwortet mit:
{
  "program": "358",
  "loanAmount": 50000,
  "termYears": 15,
  "type": "Kredit",
  "monthlyPayment": 351.24,
  "totalPayment": 63223.0,
  "totalInterest": 13223.0,
  "effectiveInterestRate": 2.75,
  "tilgungszuschuss": 0,
  "netLoanAmount": 50000,
  "notes": "Zinssatz: 2.75% p.a. effektiv"
}

Claude: "Berechne den Zuschuss für eine 15.000€ Wärmepumpen-Anlage im KfW 458"

Server antwortet mit:
{
  "program": "458",
  "loanAmount": 15000,
  "type": "Zuschuss",
  "monthlyPayment": 0,
  "tilgungszuschuss": 10500,
  "netLoanAmount": 4500,
  "subsidyPercentage": 70,
  "notes": "70% Zuschuss = 10500€ nicht rückzahlbar"
}

kfw-mcp/
├── src/
│   ├── index.ts                 # MCP Server Entry Point
│   ├── tools/
│   │   ├── listPrograms.ts      # Tool 1: Programmübersicht
│   │   ├── programDetails.ts    # Tool 2: Details
│   │   ├── checkEligibility.ts  # Tool 3: Eignung
│   │   └── calculateFunding.ts  # Tool 4: Berechnung
│   ├── utils/
│   │   └── scraper.ts           # Web-Scraping-Hilfsfunktionen
│   └── data/
│       └── kfw-programs.json    # Statische Programmdatenbank
├── dist/                        # Kompilierte JavaScript-Dateien
├── package.json
├── tsconfig.json
└── README.md

# TypeScript compilieren
npm run build

# Server starten
npm start

# Entwicklungsmodus (mit Auto-Rebuild)
npm run dev

{
  "programs": [
    {
      "id": "358",
      "name": "KfW 358 - ...",
      "interestRate": { "current": 2.75, "unit": "% p.a. effektiv" },
      ...
    }
  ]
}