Sber Mcp

io.github.theYahia由 GitHub 账号 theYahia 发布v1.0.0更新于 Oct 24, 2026

MCP server for Sberbank API — accounts, statements. Bearer token auth.

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

面向 Sberbank 企业 API 的 MCP 服务器，让助手查询账户、余额和流水，并可创建付款。

可以做什么
列出客户账户并查询账户余额，同时可获取企业信息与已保存的交易对手。按期间获取账户流水，包含交易列表与分页，并将交易汇总为笔数、收入、支出和净额。按请求 ID 幂等地创建付款委托，并按付款 ID 查询付款状态。
适用场景
适合需要从对话助手而非网银查看 Sberbank 企业账户余额、查看或汇总流水，以及起草和跟踪付款委托的场景。最适合已具备 Sberbank 企业 API 访问权限和凭据的用户。
运行要求
通过 npx（Node.js）以 stdio 在本地运行，或以 Streamable HTTP 方式在指定端口运行。需要 Sberbank API 凭据：Bearer 令牌（SBER_TOKEN 或 SBER_ACCESS_TOKEN），或 OAuth 客户端凭据（SBER_CLIENT_ID 与 SBER_CLIENT_SECRET）。可选 mTLS 证书配置，以及基础地址、OAuth 地址、scope 和超时的覆盖设置。需要访问 Sberbank 主机的网络。
安装前请注意
涉及银行凭据，若使用 mTLS 还涉及证书文件与口令，请勿放入共享配置。create_payment 工具会发起真实付款委托，涉及资金转移，确认前应核对金额与收款方。README 说明该实现尚未在 Sberbank 真实环境中验证，端点路径与参数应依据你的接入合同核对。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Sber Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

MCP-сервер для бизнес-API Сбербанка — счета, выписки и платежи через ИИ

Если вы искали, как подключить СберБизнес API к нейросети, посмотреть баланс и выписку по расчётному счёту или собрать платёж не открывая интернет-банк — это оно. 8 инструментов: счета, баланс, выписки, платежи, контрагенты. Спрашиваете «сколько пришло на счёт за неделю» — получаете сумму и список поступлений.

[npm] [CI] [License: MIT] [smithery badge]

Часть серии WWmcp от @theYahia.

Быстрый старт

Claude Desktop

json
{  "mcpServers": {    "sber": {      "command": "npx",      "args": ["-y", "@theyahia/sber-mcp"],      "env": {        "SBER_TOKEN": "ваш-bearer-токен"      }    }  }}

Claude Code

bash
claude mcp add sber -e SBER_TOKEN=ваш-токен -- npx -y @theyahia/sber-mcp

VS Code / Cursor

json
{  "servers": {    "sber": {      "command": "npx",      "args": ["-y", "@theyahia/sber-mcp"],      "env": {        "SBER_TOKEN": "ваш-bearer-токен"      }    }  }}

Windsurf

json
{  "mcpServers": {    "sber": {      "command": "npx",      "args": ["-y", "@theyahia/sber-mcp"],      "env": {        "SBER_TOKEN": "ваш-bearer-токен"      }    }  }}

Streamable HTTP (удалённо / Docker)

bash
PORT=3000 npx -y @theyahia/sber-mcp --http

Эндпоинты:

  • POST /mcp — MCP Streamable HTTP транспорт
  • GET /health — проверка здоровья ({ "status": "ok", "tools": 8 })

Переменные окружения

Авторизация — либо прямой Bearer-токен, либо пара OAuth-кредов:

ПеременнаяОбязательнаОписание
SBER_TOKENодин изПрямой Bearer-токен API (синоним SBER_ACCESS_TOKEN)
SBER_CLIENT_ID + SBER_CLIENT_SECRETодин изOAuth client_credentials
SBER_BASE_URLнетAPI-хост (дефолт https://fintech.sberbank.ru:9443)
SBER_OAUTH_URLнетOAuth-эндпоинт (дефолт https://api.sberbank.ru:8443/prod/tokens/v2/oauth)
SBER_OAUTH_SCOPEнетSpace-separated scope (дефолт GET_STATEMENT_ACCOUNT PAY_DOC_RU GET_CLIENT_ACCOUNTS)
SBER_TIMEOUT_MSнетТаймаут запроса в мс (дефолт 30000)
SBER_PFX_PATH / SBER_PFX_PASSPHRASEнетmTLS: путь к .p12/.pfx и пароль
SBER_CERT_PATH / SBER_KEY_PATH / SBER_CA_PATHнетmTLS: отдельные PEM-файлы (альтернатива PFX)
PORTнетПорт HTTP-транспорта (дефолт 3000)

Инструменты (8)

Счета

ИнструментОписание
get_accountsСписок счетов клиента
get_balanceБаланс по счёту

Выписки

ИнструментОписание
get_statementВыписка по счёту за период (список транзакций, пагинация)
summarize_transactionsСводка: количество, поступления, списания, чистый итог

Платежи

ИнструментОписание
create_paymentСоздание платёжного поручения (идемпотентно по RqUID)
get_payment_statusСтатус платежа по ID

Контрагенты / Организация

ИнструментОписание
list_counterpartiesСписок сохранённых контрагентов
get_company_infoСведения об организации (реквизиты, ИНН, счета)

Demo-промпты

Покажи мои счета и баланс по рублёвому счёту
Сделай сводку транзакций по счёту 40702… за май: сколько пришло, сколько ушло, чистый итог
Создай платёжку на 150 000 ₽ контрагенту ООО «Ромашка», БИК 044525225, назначение «Оплата по договору №7», затем проверь статус

Архитектура

  • Авторизация: прямой Bearer-токен (SBER_TOKEN) или OAuth client_credentials (SBER_CLIENT_ID/SBER_CLIENT_SECRET, Basic-auth + scope), при необходимости поверх mTLS.
  • Идемпотентность: каждая денежная операция несёт один стабильный x-Introspect-RqUID (32 hex) + rq_uid в теле, который переиспользуется на всех ретраях — Сбер дедуплицирует повтор и не создаёт второй платёж. Можно передать свой ключ.
  • Таймаут / ретраи: 30с (настраивается), 3 попытки на 429/5xx/таймаут/сетевой сбой с экспоненциальной задержкой (1с, 2с, 4с). Refresh OAuth-токена защищён от конкуренции.
  • Транспорт: stdio (по умолчанию) или Streamable HTTP (--http / PORT).

Соответствие API

Боевой СберБизнес API закрыт за mTLS и заявкой в банк, поэтому реализация не проверена против живого окружения. Дефолты хостов, путей и scope соответствуют официальной документации (developers.sber.ru/docs/ru/sber-api, developers.sber.ru) на дату ресёрча, но точные пути эндпоинтов и имена параметров сверяйте с вашим интеграционным договором — у Сбера сосуществуют поколения API (v2 direct / v3 partners). Все хосты переопределяются через SBER_BASE_URL, SBER_OAUTH_URL, SBER_OAUTH_SCOPE. Пометки VERIFY в исходниках указывают на места, требующие сверки.

Лицензия

MIT — часть серии WWmcp.

Часть WWmcp · Telegram: @vhodvai

来源：README.md，提交 d9b7d34

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分