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