Beancount.io MCP
Beancount.io дает агенту книги учета: запросы BQL, правка файлов, проводки, разбор выписок и импорт из банка.
- 336 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент вставляет проводки и правит файлы финансовых книг.
- Содержимое книг и выписок попадает в контекст модели.
Установка
- Работает в
Ручная установка
brew install bex-co/tap/beaКомандная строка `bea` для локальной книги и навыков. MCP подключают отдельно, адресом развертывания.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент вставляет проводки и правит файлы финансовых книг.
- Содержимое книг и выписок попадает в контекст модели.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Beancount.io — открытая платформа двойной бухгалтерии на простом тексте: книги лежат в файлах `.bean`, поверх них отчеты, мобильные приложения, командная строка и агенты. Для агентов есть удаленный MCP-сервер, он же записан в реестре MCP как `io.beancount/beancount` с входом по OAuth, и шестнадцать навыков `beancount-*` для Claude Code и Codex. Инструменты MCP охватывают запросы BQL, чтение и правку файлов, вставку проводок и чеков, разбор выписок и банковский импорт. Ресурсы с адресами и бухгалтерские подсказки ведут отчеты о расходах, закрытие месяца, сверку и категоризацию импорта, например `/mcp__beancount__close-month`. Навыки создают книгу, ведут проводки, зарплаты, сделки по инвестициям и события недвижимости, сверяют выписки и импортируют без дублей. Каждая запись проверяется и обратима.
Для кого. Тем, кто ведет личный или малый бизнес-учет в Beancount и хочет поручать агенту проводки, сверки и отчеты.
Подходит, если
- Банковскую выписку импортируют без дублей и раскладывают по счетам.
- Запрос BQL показывает расходы по категориям за квартал.
- Месяц закрывают по готовой подсказке, а остатки сверяют с выписками.
- Чек превращают в проводку и вставляют в книгу с проверкой.
Не подходит, если
- Учет ведется в таблице или бухгалтерской программе без Beancount: сервер работает с форматом `.bean`.
- Агенту нельзя править финансовые файлы: инструменты записывают проводки.
- Нужен налоговый или юридический совет: сервер ведет учет, а не консультирует.
Пример запроса к агенту
Покажи расходы по категориям за прошлый квартал запросом BQL и подготовь закрытие месяца по подсказке.MCP
- Транспорт
- http
- Авторизация
- OAuth
Переменные окружения
BEANCOUNT_MCP_TOKENсекрет- Токен для заголовка Authorization при подключении к своему развертыванию
Ограничения
MCP-сервер подключают к развертыванию платформы по адресу `https://<развертывание>/api-gateway/mcp`, в реестре MCP размещенный экземпляр вход выполняет по OAuth. Локальные навыки работают с вашей книгой на диске командой `bea` (`brew install bex-co/tap/bea` или `uv tool install beancount-io`, нужен Python 3.12 или новее). Агент меняет финансовые данные, хотя каждая запись проверяется и обратима, а содержимое книги попадает в контекст модели. Платформа может размещаться как облачно, так и на вашем сервере или ноутбуке.
Как отключить. Удалите запись `beancount` из клиента и отзовите доступ OAuth в аккаунте. Книги остаются в виде текстовых файлов, их история хранится отдельно.
Частые вопросы
Что входит в MCP?
Запросы BQL, чтение и правка файлов, вставка проводок и чеков, разбор выписок и банковский импорт, плюс ресурсы по адресам и бухгалтерские подсказки.
Как поставить командную строку?
`brew install bex-co/tap/bea` в macOS и Linuxbrew или `uv tool install beancount-io` с Python 3.12 и новее.
Сколько навыков для агентов?
Шестнадцать навыков `beancount-*` для Claude Code и Codex: создание книги, проводки, зарплаты, импорт, сверка, миграции.
Можно ли хранить данные у себя?
Да: облачно, локально или на своем сервере. Для сервера есть каталоги `deploy/docker` и `deploy/docker-mac`.
Безопасны ли записи агента?
Каждая запись проверяется и обратима по описанию проекта. Книги лежат в текстовых файлах, которые можно сверять в системе контроля версий.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыBeeCount Cloud MCP — MCP-сервер для своего учета: отдельные права дают агенту чтение отчетов или изменение операций.
Сервер дает агенту чтение ваших банковских счетов и операций через Enable Banking без инструментов отправки платежей.
Официальный MCP-сервер Xero: агент смотрит счета, контакты, проводки и отчеты в бухгалтерии, а также создает счета, платежи и табели
Учет инвестиций и расходов с встроенным MCP-сервером: агент читает портфель, а записи делает через черновики
Официальный локальный MCP-сервер Intuit: агент ищет и создает счета, платежи и контрагентов в QuickBooks Online, строит отчеты
MCP-сервер финансового анализа: более 500 методов из отчетностей компаний, коэффициенты, индикаторы, метрики риска и макро
Коротко о README
README рассказывает о платформе, трех путях знакомства, быстром старте с командной строкой, разделе «Agents and MCP» с подключением, таблице сравнения и вариантах самостоятельного развертывания.