Shelter

Shelter MCP Server

Claude、Codex、Cursor、その他のMCP対応エージェントを、独自のShelterアカウントにある、範囲を限定した財務情報に接続します。

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

要件

• Node.js 20以降
• 金融データを連携済みのShelterアカウント
• shelter.money/developerから取得した、範囲を限定したAPIキー

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

クイックスタート

APIキーを作成し、MCPクライアントが次を実行するように設定します。

npx -y @shelter.money/mcp

サーバー環境にSHELTER_API_KEYを設定してください。

Claude Code

このサーバーとShelterスキルをまとめたShelterプラグインをインストールします。

/plugin marketplace add nextauralabs/shelter-skill
/plugin install shelter@shelter-skills

Claude Codeを起動する前に、シェルでSHELTER_API_KEYをエクスポートしてください。または、サーバーのみを追加します。

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

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	はい	Shelterで作成した、範囲を限定したキーです。秘密にしてください。
SHELTER_API_URL	いいえ	APIのベースURLです。デフォルトはhttps://api.shelter.money/agentです。
PORT	HTTPモードのみ	ローカルHTTPポートです。デフォルトは3100です。

SHELTER_API_KEYが設定されていない場合も、サーバーはツール定義を公開しますが、財務上の値を含まない抑制された応答を返します。ユーザーの実際の財務状況の代わりに、サンプルの金額データを使用することはありません。

セキュリティモデル

• エンドユーザーの身元情報は、範囲を限定した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

Claude Market MCPディレクトリに掲載されています。