Shelter

Shelter MCP 服务

将 Claude、Codex、Cursor 和其他兼容 MCP 的 Agent 连接到你自己的 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 前，请在 shell 中导出 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：供 Agent 推理使用的受限范围财务信息
• 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 目录。