Мок-сервер API Т-Банка для разработки
Mock T-Bank API Server
FastAPI-заглушка API Т-Банк Бизнес для локальной разработки и тестов tbank-mcp: 20+ эндпоинтов, три месяца тестовых данных, без реальных денег
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Все данные и операции живут только в памяти мок-сервера и не касаются реального банка
- Переключение tbank-mcp на боевой адрес Т-Банка происходит вне этого репозитория и без дополнительной защиты
Установка
Ручная установка
pip install -r requirements.txt && python mock_tbank_api.pyПоднимает мок на http://127.0.0.1:8099, данные подгружаются из папки data.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на FastAPI имитирует REST API Т-Банк Бизнес и служит подменой боевого адреса для MCP-сервера tbank-mcp (отдельный проект, не входит в этот репозиторий): достаточно поменять TBANK_BASE_URL на адрес мока, код tbank-mcp не меняется. Реализует более 20 эндпоинтов: компания и реквизиты, счета и балансы, выписки, платежи и черновики платежей, переводы СБП, счета на оплату, зарплатные выплаты и карты, регистрация и оплата самозанятых, бизнес-карты и лимиты, операции эквайринга, ссылки СБП для B2B-оплаты. При старте подгружает три месяца истории из JSON-файлов в data: счета, клиенты, поставщики, план счетов и тестовые сценарии, все состояние держится в памяти и сбрасывается при перезапуске.
Для кого. Для разработчиков, которые пишут или тестируют интеграцию с MCP-сервером tbank-mcp и хотят проверить сценарии без обращения к продакшену Т-Банка.
Подходит, если
- Разрабатываете или тестируете tbank-mcp и не хотите использовать боевой токен и реальные деньги
- Нужны предсказуемые тестовые данные: счета, платежи, инвойсы, зарплатные выплаты, эквайринг
- Нужен E2E-тест сценариев бизнес-платежей без сети и реального банка
Не подходит, если
- Нужен реальный доступ к API Т-Банк Бизнес: это только заглушка, а не клиент или MCP-сервер к продакшену
- У вас нет самого tbank-mcp: этот репозиторий только имитирует его backend, MCP-сервер нужно ставить отдельно
- Нужна защита от случайного переключения на продакшен: смена TBANK_BASE_URL на боевой адрес происходит одной строкой конфига и мок никак этому не препятствует
Пример запроса к агенту
Подними мок Т-Банка и прогони E2E-тесты по счетам, платежам и эквайрингу для tbank-mcpОграничения
Лицензии GitHub API для репозитория не показывает как отдельное поле, README указывает MIT в тексте. Это не сам MCP-сервер: он должен быть установлен отдельно и настроен на TBANK_BASE_URL мока. Токен по умолчанию mock-token-any-value, менять его нужно явно переменной MOCK_TOKEN. Переключение на продакшн Т-Банка это простая смена трех переменных окружения без дополнительной защиты.
Как отключить. Остановите процесс python mock_tbank_api.py и верните tbank-mcp переменную TBANK_BASE_URL на боевой или предыдущий адрес.
Проверка безопасности
- Все данные и операции живут только в памяти мок-сервера и не касаются реального банка
- Переключение tbank-mcp на боевой адрес Т-Банка происходит вне этого репозитория и без дополнительной защиты
Коротко о README
README дает архитектурную диаграмму связки агент, tbank-mcp и мок, полный список эндпоинтов по разделам компания, счета, платежи, инвойсы, зарплата, самозанятые, карты, эквайринг и ссылки СБП, описание предзагруженных тестовых данных за три месяца, инструкции по curl для ручной проверки, отдельный раздел инструкций для ИИ-агентов о формате ответов tbank-mcp и предупреждение не путать встроенные инструменты агента с моком.
Частые вопросы
Можно ли повредить реальный счет через мок?
Нет, все операции выполняются в памяти мок-сервера и сбрасываются при перезапуске, к продакшену Т-Банка обращений нет.
Как вернуться на боевой API?
Поменять в конфиге tbank-mcp TBANK_ENVIRONMENT на production, TBANK_BASE_URL на secured-openapi.tbank.ru и указать настоящий токен, код менять не нужно.
Похожие
CLI для тестирования и ред-тиминга LLM-приложений: сравнение моделей, автоматические проверки в CI и поиск уязвимостей
Playwright CLI
playwright-cli
Официальный CLI Playwright со скиллом для агентов: управление браузером короткими командами без тяжелых MCP-схем
Официальный отладчик MCP-серверов: веб-интерфейс, CLI для автоматизации и терминальный интерфейс в одном пакете
Официальный MCP-сервер SonarSource: проблемы качества и безопасности, quality gates и анализ кода из SonarQube Server и Cloud