Servidor MCP de Fondos de Ayuda KfW

Un servidor MCP (Model Context Protocol) para consultar los programas de ayuda de KfW para la renovación energética de edificios residenciales en Alemania.

Parte de la plataforma "Sanierungskompass" (Brújula de Renovación): conecta a los propietarios de viviendas con asesores energéticos y las opciones de financiación actuales de KfW.

¿Qué es la ayuda de KfW?

El Kreditanstalt für Wiederaufbau (KfW) ofrece préstamos a bajo interés y subvenciones para:

• Renovación energética de edificios (BEG - Ayuda Federal para Edificios Eficientes)

• Sustitución de sistemas de calefacción y fuentes de calor renovables

• Medidas individuales como ventanas, aislamiento y trabajos de ventilación

• Renovaciones integrales según los estándares de eficiencia energética de KfW (KfW-Effizienzhaus)

Related MCP server: FluentLab Funding Assistant

Características

• 4 herramientas MCP para consultas de datos de KfW

• Datos actuales de programas KfW (2025/2026)

• Base de datos estática de respaldo con programas comunes

• Tipos de interés y condiciones de préstamo con cálculo

• Determinación de la subvención de amortización (parte del préstamo financiada mediante subvención)

• Implementación con tipado seguro en TypeScript

Instalación

Paquete NPM

npm install @sanierungskompass/kfw-mcp

Desde el código fuente

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

Uso

Iniciar como servidor MCP

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

El servidor escucha en Stdin/Stdout en el formato de protocolo MCP.

Configurar con Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o el equivalente en Windows/Linux:

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

Luego, active el servidor en Claude.

Con Claude Code

# 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

Herramientas disponibles

1. kfw_list_programs

Enumera todos los programas de KfW disponibles para la renovación de edificios residenciales.

Entrada: No se requieren parámetros

Salida: Matriz con programas (ID, nombre, tipo, categoría, descripción)

Ejemplo:

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"
    }
  },
  ...
]

2. kfw_get_program_details

Obtiene información detallada sobre un programa específico de KfW.

Parámetros:

• program_number (string, obligatorio): Número de programa de KfW (p. ej., "358", "261", "458", "459")

Salida: Información detallada del programa

Ejemplo:

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"
}

3. kfw_check_eligibility

Comprueba qué programas de KfW son adecuados para una medida de renovación específica.

Parámetros:

• measure (string, obligatorio): Medida de renovación (p. ej., "Fenstertausch" (cambio de ventanas), "Dachdämmung" (aislamiento de tejado), "Heizungsaustausch" (cambio de calefacción), "Wärmepumpe" (bomba de calor))

• building_type (string, opcional): Tipo de edificio (p. ej., "Wohngebäude" (edificio residencial))

• is_owner_occupied (boolean, opcional): ¿Ocupado por el propietario?

Salida: Programas aplicables con recomendaciones

Ejemplo:

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."
  ]
}

4. kfw_calculate_funding

Calcula las cuotas de préstamo estimadas y los importes de financiación para un programa de KfW.

Parámetros:

• program (string, obligatorio): Número de programa de KfW (p. ej., "358", "458")

• loan_amount (number, obligatorio): Importe del préstamo/subvención en EUR

• term_years (number, opcional): Plazo en años (estándar: 15 años para préstamos)

Salida: Cálculo con cuota mensual, carga total, tipo de interés y subvención de amortización

Ejemplo:

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"
}

Para subvenciones (p. ej., KfW 458):

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"
}

Programas KfW compatibles

(Otros programas como 455, 440, 461 como programas en fase de finalización en el conjunto de datos)

Lógica del programa

Obtención de datos

1. Primaria: Respaldo en base de datos estática (src/data/kfw-programs.json)

2. Secundaria: Intento de extraer datos en vivo de https://www.kfw.de/inlandsfoerderung/Privatpersonen/Bestandsimmobilien/

3. En caso de error de extracción → Se utilizan automáticamente los datos estáticos

Cálculo del importe de financiación

Para préstamos:

• Cuota mensual: Fórmula de anualidad estandarizada con interés compuesto

• La subvención de amortización se deduce de la base del préstamo

• Tipo de interés efectivo según las especificaciones de KfW

Para subvenciones:

• Subvención porcentual sobre los costes totales

• KfW 458: Base 30% + bonificaciones adicionales (hasta un máximo del 70%)

• KfW 459: Base 15% + estándares (hasta un máximo del 25%)

Desarrollo

Estructura del proyecto

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

Construcción y prueba

# TypeScript compilieren
npm run build

# Server starten
npm start

# Entwicklungsmodus (mit Auto-Rebuild)
npm run dev

Actualizar datos

Los datos de programas y tipos de interés pueden actualizarse en src/data/kfw-programs.json:

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

Licencia

Licencia MIT - Ver archivo LICENSE

Contacto

Tim Fellendorf timfellendorf@googlemail.com

Parte del proyecto Sanierungskompass para apoyar la renovación energética de edificios en Alemania.