ru-buh 🇷🇺📊

Open-source bookkeeping + tax knowledge layer для российских бухгалтеров. Markdown skills + MCP-серверы к ФНС, 1С, СБИС, ПФР/ФСС. Apache 2.0. Подключи через MCP к Claude Code / Cursor / LangGraph / своему боту.

⚠ AI-инструмент, не замена бухгалтера. Налоговое законодательство РФ меняется ежемесячно — финальную ответственность несёт бухгалтер. См. DISCLAIMER.md.

---

Что это

ru-buh — content + access layer для AI-агентов работающих с российской бухгалтерией. Две вещи:

1. Skills (Markdown playbooks) — кодифицированные workflow'ы по налогам, отчётности, кадрам, учёту
2. MCP-серверы — интеграции с ФНС, ПФР/ФСС, СБИС, ОФД, 1С, реестрами

Sister-проект ru-legal для юристов — общая инфраструктура, разная audience.

Зачем это нужно

Бухгалтер делает 80% работы по типовым процедурам:

• Расчёт НДС / прибыли / зарплаты
• Подготовка деклараций (РСВ, 6-НДФЛ, 3-НДФЛ, УСН, НДС)
• Проверка контрагентов перед сделкой
• Реакция на требования ФНС
• Кассовая дисциплина / онлайн-кассы

Сейчас всё делается через 1С + 5 вкладок: nalog.gov.ru, pravo.gov.ru, СБИС, Контур, e-disclosure. AI без procedural workflow либо галлюцинирует устаревшие нормы, либо забывает шаги (контролируемые показатели → штраф ФНС).

Нужны две вещи:

• 🧠 Skills — операционализированные процедуры (что делать пошагово)
• 🌐 MCP — доступ к живым источникам (актуальная редакция НК, ставки, реестры)

Архитектура — два слоя

┌─────────────────────────────────────────────────────────┐
│  ru-buh (этот repo)                                      │
│  Open-source bookkeeping/tax knowledge + data layer      │
│                                                          │
│  ├── packs/         — skills (Markdown с YAML frontmatter)│
│  └── mcps/          — MCPs к ФНС/1С/ОФД/ПФР/ФСС          │
└─────────────────────┬───────────────────────────────────┘
                      │ MCP protocol
                      ▼
              ANY MCP-compatible client:
   ┌──────────┬────────────┬──────────┬─────────────┐
   ▼          ▼            ▼          ▼             ▼
Claude Code Cursor    Continue   LangGraph   ru-legal-agent
 (plugin)  (.mcp.json) (.json)   (langchain   (shared harness)
                                  MCP adapter)

Quick start

Подключить через Claude Code / Cursor

// .mcp.json
{
  "mcpServers": {
    "ru-buh": {
      "command": "uvx",
      "args": ["ru-buh-mcp"]
    }
  }
}

Теперь LLM-клиент видит:

• N skills как slash-commands
• Skill management tools (find_skill, get_skill, list_skills)
• MCP tools из под-серверов (fns.check_msp_status(inn), pfr.rsv_status(), ...)

Использовать через ru-legal-agent

ru-legal-agent --pack=ru-buh
> Рассчитай страховые взносы за май 2026 для ИП на УСН доходы с 1 сотрудником
[агент → roadmap → расчёт → отчёт]

Что включено (в развитии)

Skills packs (alpha v0.1 — будет растить)

🟢 = в разработке Phase 1, 🟡 = Phase 2, 🔵 = Phase 3

| Pack | Status | Что покрывает | |---|---|---| | simplified-tax | 🟢 | УСН доходы / доходы-расходы, авансы, декларация | | self-employed | 🟢 | НПД (самозанятые) — регистрация, чеки, лимиты | | vat-management | 🟢 | НДС учёт, декларация, вычеты, возмещение | | payroll-basics | 🟢 | Зарплата + НДФЛ + страховые взносы | | bookkeeping-reports | 🟢 | Бух.отчётность (БУХ-1, БУХ-2, налоговая) | | profit-tax | 🟡 | Налог на прибыль организаций | | personal-income-tax | 🟡 | НДФЛ детально (3-НДФЛ, вычеты) | | insurance-contributions | 🟡 | РСВ детально, страховые взносы | | tax-audit-defense | 🟡 | Защита от выездных / камеральных проверок ФНС | | fixed-assets | 🔵 | Основные средства учёт | | inventory-accounting | 🔵 | ТМЦ учёт | | cash-discipline | 🔵 | Касса, онлайн-кассы (54-ФЗ) | | forex-accounting | 🔵 | Валютные операции | | ip-taxation | 🔵 | Налогообложение ИП (все режимы) |

MCP servers

🟢 = в разработке Phase 1

| MCP | Status | Источники | |---|---|---| | fns-mcp | 🟢 | nalog.gov.ru API — Реестр МСП, самозанятые, ИП, статус деклараций | | pfr-fss-mcp | 🟢 | ПФР + ФСС — РСВ, СЗВ-ТД, больничные, материнские | | ofd-mcp | 🟡 | Operators of Fiscal Data — онлайн-кассы, чеки | | 1c-mcp | 🟡 | 1С (Бухгалтерия / Зарплата) — chтение проводок, справочников | | sbis-mcp | 🟡 | СБИС API — электронная отчётность | | kontur-mcp | 🔵 | Контур.Эльба/Бухгалтерия | | cbr-rates-mcp | 🟢 | ЦБ РФ — курсы валют, ключевая ставка (общий с ru-legal) |

Roadmap

См. ROADMAP.md.

Краткие фазы:

• Phase 1 (Q4 2026 / Q1 2027): 5 паков + 3 MCP — покрыть mainstream бухгалтерии РФ
• Phase 2: +4 пака + 3 MCP — расширение в депт.учёт + защита от проверок
• Phase 3: niche домены + community-driven contributions

Status

🟡 Alpha (запланировано к публичному релизу: Q4 2026)

Сейчас проект в design phase. Skill format уже отработан в sister-проекте ru-legal — переиспользуем.

Лицензия

Apache 2.0. Используй, форкай, модифицируй. PR welcome.

Disclaimer

⚠ Это AI-инструмент. Skills и MCP помогают бухгалтеру делать работу быстрее, не заменяют проверку. Налоговое законодательство меняется — финальный отчёт всегда проверяется глазами специалиста. См. DISCLAIMER.md.

Связь

• Sister project: ru-legal
• Telegram: @alskozlov
• Issues / Discussions: на этом репо
• Email: als.kozlov@yandex.ru