Shelter MCP Server

Verbinden Sie Claude, Codex, Cursor und andere MCP-kompatible Agents mit eingeschränktem finanziellem Kontext aus Ihrem eigenen Shelter-Konto.

Der Server ist schreibgeschützt. Er kann Prognosen, Runway, Warnmeldungen, Chancen und Erschwinglichkeitshinweise abrufen, kann aber kein Geld bewegen und hat keinen Zugriff auf Plaid-Anmeldeinformationen.

Voraussetzungen

• Node.js 20 oder neuer

• Ein Shelter-Konto mit verbundenen Finanzdaten

• Ein eingeschränkter API-Schlüssel von shelter.money/developer

Es ist kein Plaid-Entwicklerkonto erforderlich.

Related MCP server: toshl-mcp-server

Schnellstart

Erstellen Sie einen API-Schlüssel und konfigurieren Sie dann Ihren MCP-Client so, dass er Folgendes ausführt:

npx -y @shelter.money/mcp

mit SHELTER_API_KEY in der Serverumgebung.

Claude Desktop

{
  "mcpServers": {
    "shelter": {
      "command": "npx",
      "args": ["-y", "@shelter.money/mcp"],
      "env": {
        "SHELTER_API_KEY": "wv_your_key_here"
      }
    }
  }
}

Starten Sie Claude Desktop neu, nachdem Sie die Konfiguration gespeichert haben.

Codex

codex mcp add shelter --env SHELTER_API_KEY=wv_your_key_here -- npx -y @shelter.money/mcp

Cursor

Fügen Sie diesen Server in den MCP-Einstellungen von Cursor hinzu:

{
  "shelter": {
    "command": "npx",
    "args": ["-y", "@shelter.money/mcp"],
    "env": {
      "SHELTER_API_KEY": "wv_your_key_here"
    }
  }
}

Verfügbare Tools

• shelter_status — Verbindungs- und Berechtigungsstatus

• shelter_runway — Runway für sichere Ausgaben und bevorstehende finanzielle Belastungen

• shelter_forecast — an das Manifest gebundene Cashflow-Prognose

• shelter_alerts — aktuelle Finanzwarnungen

• shelter_opportunities — umsetzbare Sparmöglichkeiten

• shelter_context — eingeschränkter finanzieller Kontext für das Reasoning des Agents

• shelter_affordability — Kauf-Erschwinglichkeitssimulation

• shelter_coach_daily — tägliche Coaching-Zusammenfassung

• shelter_coach_advice — Coaching zu einem angeforderten Thema

• shelter_ask — stellen Sie Guardian eine Finanzfrage

Das Paket bietet außerdem Prompts für den Finanz-Check-up, die Ausgabenüberprüfung und die Kaufplanung.

Umgebungsvariablen

Wenn SHELTER_API_KEY fehlt, stellt der Server weiterhin seine Tool-Definitionen bereit, gibt aber unterdrückte Antworten ohne Finanzwerte zurück. Er setzt niemals Beispiel-Finanzdaten an die Stelle des realen Finanzstatus eines Benutzers.

Sicherheitsmodell

• Die Identität des Endbenutzers stammt ausschließlich aus dem eingeschränkten Shelter-API-Schlüssel.

• Schlüssel werden von Shelter als SHA-256-Hashes gespeichert und bei der Erstellung nur einmal angezeigt.

• Schlüssel können über die Shelter-Entwicklerseite eingeschränkt und widerrufen werden.

• Die gehostete Agent-API wendet Authentifizierung, Autorisierung, Ratenbegrenzung und Audit-Protokollierung an.

• Das MCP-Paket enthält keinen Shelter-Backend-Code, keine Bereitstellungsgeheimnisse, keine Plaid-Tokens und keine Bankanmeldeinformationen.

• Wenn keine autoritativen Daten verfügbar sind, fallen finanzielle Antworten geschlossen aus.

Behandeln Sie den API-Schlüssel wie ein Passwort. Committen Sie ihn nicht und geben Sie ihn auf gemeinsam genutzten Rechnern nicht direkt in den Befehlsverlauf ein. Informationen zur Meldung von Schwachstellen finden Sie in SECURITY.md.

Entwicklung

npm ci
npm run typecheck
npm run build

Führen Sie den stdio-Server aus dem erstellten Paket aus:

SHELTER_API_KEY=wv_your_key_here node dist/bin/shelter-mcp.js

Für kontrolliertes Hosting wird außerdem ein zustandsloser Streamable-HTTP-Einstiegspunkt erstellt:

SHELTER_API_KEY=wv_your_key_here npm start

Der HTTP-Einstiegspunkt bindet an 0.0.0.0 und ist nicht das empfohlene Setup für persönliche Clients. Verwenden Sie stdio, es sei denn, Sie betreiben und sichern die HTTP-Umgebung selbst.

Architektur

Dieses öffentliche Repository enthält nur den MCP-Adapter. Er ruft die gehostete, schreibgeschützte Agent-API von Shelter auf. Die privaten Finanzberechnungen von Shelter, das Authentifizierungs-Gateway, das Datenbankschema und die Dienst-Anmeldeinformationen sind nicht Teil dieses Pakets.

Lizenz

MIT