drebedengi-mcp

MCP-сервер для drebedengi.ru («Дребеденьги», домашняя бухгалтерия). Работает через официальный SOAP API сервиса (https://www.drebedengi.ru/soap/), без парсинга сайта.

Инструменты

Суммы везде в рублях (не в копейках). Счета, категории, источники и теги можно указывать по id или по названию (без учёта регистра и эмодзи; «Еда» найдёт «🥪 Еда»). При неоднозначности сервер вернёт список вариантов с id.

Related MCP server: myfinance-mcp

Установка

Нужен Node.js 18+.

git clone https://github.com/hawk911/drebedengi-mcp.git
cd drebedengi-mcp
npm install
cp .env.example .env

Откройте .env и впишите логин (e-mail), пароль и API ID. Затем проверьте подключение:

npm run check

API ID обязателен для личного аккаунта. Публичный demo_api работает только с демо-аккаунтом (для своего аккаунта сервер ответит Login failed. API ID 'demo_api' is invalid). Собственный API ID выдаёт поддержка drebedengi.

npm run smoke — проверка всех инструментов чтения на вашем аккаунте (режим только чтения, выводит только количества).

Нагрузка на сервер

Правила drebedengi: не создавать поток запросов и не перезапрашивать одни и те же данные в большом объёме (для этого есть getChangeList). Поэтому:

• запросы к API идут строго по одному, с паузой не меньше DREBEDENGI_MIN_INTERVAL_MS (по умолчанию 1 с);

• справочники (счета, категории, источники, валюты, теги) загружаются один раз; затем не чаще чем раз в 10 минут сервер сверяет ревизию (getCurrentRevision) и через getChangeList перезагружает только изменившиеся списки; раз в 6 часов справочники обновляются полностью на случай, если ревизия что-то не отразила;

• если название не найдено в кэше, перезагружается только нужный список (не чаще раза в минуту);

• после добавления/изменения операции подтверждение собирается локально, без повторного чтения.

Первый вызов после запуска — около 7 запросов (≈10 с), следующие — 1–2 запроса.

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

Переменные можно задать в .env рядом с package.json или в конфиге MCP-клиента (env).

Подключение

Claude Code (укажите свой путь к папке):

claude mcp add drebedengi -- node /path/to/drebedengi-mcp/src/server.js

Claude Desktop — %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "drebedengi": {
      "command": "node",
      "args": ["C:/path/to/drebedengi-mcp/src/server.js"]
    }
  }
}

Тесты

npm test прогоняет все инструменты через MCP-клиент на публичном демо-аккаунте (demo@example.com / demo): создаёт тестовые операции и затем удаляет их. На свой аккаунт его не направляйте — для него есть npm run smoke (только чтение).

Особенности API

• Протокол — SOAP rpc/encoded (PHP), ассоциативные массивы передаются как ns2:Map; клиент написан вручную в src/soap.js.

• Расход хранится с отрицательной суммой, доход — с положительной. Перевод и обмен — две связанные записи (client_move_id / client_change_id), исходящая половина отрицательная.

• client_id при вставке должен быть уникальным: сервер запоминает соответствие client→server.

• Если в аккаунте закрыт период, запись задним числом будет отклонена с сообщением «Период закрыт для изменений».

Лицензия

MIT — код можно свободно копировать, изменять, распространять и использовать в любых целях, в том числе коммерческих. Единственное условие — сохранять текст лицензии с указанием автора.

Автор и владелец репозитория — Denis B. (@hawk911).