Shelter MCP 服务器

将 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，服务器仍会暴露其工具定义，但会返回不包含任何财务值的抑制响应。它绝不会用示例资金数据替代用户的真实财务状态。

安全模型

• 最终用户身份仅来自限定的 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