Shelter MCP Server

Подключите Claude, Codex, Cursor и других MCP-совместимых агентов к ограниченному финансовому контексту из вашего собственного аккаунта Shelter.

Сервер работает только для чтения. Он может получать прогнозы, запас средств, оповещения, возможности и рекомендации по доступности покупок, но не может переводить деньги или получать доступ к учётным данным Plaid.

Требования

• Node.js 20 или новее

• Аккаунт Shelter с подключёнными финансовыми данными

• API-ключ с ограниченными правами из shelter.money/developer

Аккаунт разработчика 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

Добавьте этот сервер в настройки MCP в Cursor:

{
  "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 отсутствует, сервер по-прежнему предоставляет определения своих инструментов, но возвращает ответы без каких-либо финансовых значений. Он никогда не подставляет образцы денежных данных вместо реального финансового состояния пользователя.

Модель безопасности

• Личность конечного пользователя определяется только ограниченным API-ключом Shelter.

• Ключи хранятся в Shelter в виде хешей SHA-256 и показываются только один раз при создании.

• Ключи можно ограничивать и отзывать на странице разработчика Shelter.

• Размещённый Agent API применяет аутентификацию, авторизацию, лимитирование запросов и аудит.

• Пакет MCP не содержит кода серверной части Shelter, секретов развертывания, токенов Plaid или банковских учётных данных.

• В случае отсутствия достоверных данных финансовые ответы не возвращаются (fail closed).

Относитесь к 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

Для контролируемого размещения также собирается stateless-точка входа Streamable HTTP:

SHELTER_API_KEY=wv_your_key_here npm start

HTTP-точка входа привязывается к 0.0.0.0 и не является рекомендуемой настройкой для личного клиента. Используйте stdio, если только вы сами не разворачиваете и не защищаете HTTP-окружение.

Архитектура

Этот публичный репозиторий содержит только MCP-адаптер. Он вызывает размещённый Shelter's Agent API, доступный только для чтения. Приватный расчёты Shelter, шлюз аутентификации, схема базы данных и служебные учётные данные не являются частью этого пакета.

Лицензия

MIT