Shelter MCP Server

Claude、Codex、Cursor、その他のMCP互換エージェントを、お客様自身のShelterアカウントのスコープ付き財務コンテキストに接続します。

このサーバーは読み取り専用です。予測、ランウェイ、アラート、機会、および購入可能性ガイダンスを取得できますが、資金を移動したりPlaidの認証情報にアクセスしたりすることはできません。

要件

• Node.js 20以降

• 財務データが接続されたShelterアカウント

• shelter.money/developerのスコープ付きAPIキー

Plaid開発者アカウントは不要です。

Related MCP server: toshl-mcp-server

クイックスタート

APIキーを作成し、MCPクライアントを以下のように設定して実行します:

npx -y @shelter.money/mcp

サーバー環境にSHELTER_API_KEYを設定します。

Claude Desktop

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

設定を保存した後、Claude Desktopを再起動します。

Codex

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

Cursor

このサーバーをCursorのMCP設定に追加します:

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

利用可能なツール

• shelter_status — 接続と権限のステータス

• shelter_runway — 安全に使えるランウェイと今後の圧力

• shelter_forecast — マニフェストに基づくキャッシュフロー予測

• shelter_alerts — 現在の財務アラート

• shelter_opportunities — 実行可能な節約機会

• shelter_context — エージェントの推論のためのスコープ付き財務コンテキスト

• shelter_affordability — 購入可能性シミュレーション

• shelter_coach_daily — 日次コーチングサマリー

• shelter_coach_advice — リクエストされたトピックに関するコーチング

• shelter_ask — Guardianに財務に関する質問をする

このパッケージは、財務チェックアップ、支出レビュー、購入計画のプロンプトも提供します。

環境変数

SHELTER_API_KEYがない場合、サーバーはツール定義を公開しますが、財務値を含まない抑制されたレスポンスを返します。ユーザーの実際の財務状態にサンプルの資金データを代用することはありません。

セキュリティモデル

• エンドユーザーのIDは、スコープ付きShelter APIキーのみから取得されます。

• キーはShelterによってSHA-256ハッシュとして保存され、作成時に一度だけ表示されます。

• キーはShelter開発者ページからスコープ設定と失効が可能です。

• ホスト型Agent APIは、認証、認可、レート制限、監査ログを適用します。

• MCPパッケージには、Shelterのバックエンドコード、デプロイメントシークレット、Plaidトークン、銀行認証情報は含まれません。

• 権威あるデータが利用できない場合、財務レスポンスはフェイルクローズします。

APIキーはパスワードのように扱ってください。コミットしたり、共有マシンのコマンド履歴に直接置いたりしないでください。脆弱性の報告についてはSECURITY.mdを参照してください。

開発

npm ci
npm run typecheck
npm run build

ビルドされたパッケージからstdioサーバーを実行します:

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

制御されたホスティング用に、ステートレスなStreamable HTTPエントリポイントもビルドされます:

SHELTER_API_KEY=wv_your_key_here npm start

HTTPエントリポイントは0.0.0.0にバインドされ、推奨される個人クライアント設定ではありません。自分でHTTP環境を運用・保護しない限り、stdioを使用してください。

アーキテクチャ

この公開リポジトリにはMCPアダプターのみが含まれています。Shelterのホスト型読み取り専用Agent APIを呼び出します。Shelterのプライベートな財務計算、認証ゲートウェイ、データベーススキーマ、サービス認証情報はこのパッケージの一部ではありません。

ライセンス

MIT