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 分