agent-spreadsheet — Excel для ИИ-агентов
agent-spreadsheet
MCP-сервер, CLI и SDK для агентов: правка книг Excel, пересчет формул и подтверждение изменений без автоматизации окна
- 64 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- С включенной записью агент меняет книги в рабочей папке, а перезапись исходников включается отдельно
- Содержимое ячеек попадает в контекст агента и может нести чужие инструкции
Установка
- Работает в
Ручная установка
cargo install agent-spreadsheet-mcpУстановка MCP-сервера через Cargo. Есть также Docker-образ и установочный скрипт.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- С включенной записью агент меняет книги в рабочей папке, а перезапись исходников включается отдельно
- Содержимое ячеек попадает в контекст агента и может нести чужие инструкции
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
agent-spreadsheet дает агенту единый слой для работы с таблицами в трех видах: CLI asp (он же agent-spreadsheet), состояние хранящий MCP-сервер agent-spreadsheet-mcp и TypeScript SDK с встроенным WASM-движком. Все три используют общую среду на Rust и реестр из 32 операций. Читаются и пишутся файлы .xlsx и .xlsm, для .xls и .xlsb доступно только чтение. Пересчет формул выполняет движок Formualizer на Rust: разбор формул, граф зависимостей и более 400 функций Excel. Агент пересчитывает настоящую книгу, видит, какие ячейки изменились и почему, и подтверждает это командами asp verify proof и asp verify diff. Правка идет осторожно: режимы с предпросмотром, добавление строк с учетом таблиц и итогов, клонирование шаблонной строки, именованные диапазоны, замена только формул и сессии с журналом, ветками и откатом. Ответы машиночитаемые, с постраничным выводом и компактными режимами для экономии токенов.
Для кого. Аналитикам, финансистам и разработчикам, которым агент должен править рабочие таблицы Excel с пересчетом формул и проверкой результата.
Подходит, если
- Агент должен добавить строки в таблицу с итогами и сохранить формулы
- После правки надо доказать, какие ячейки изменились и почему
- Перед крупной переделкой книги нужен анализ структурного влияния
- Из шаблонной строки требуется размножить блок строк по данным
- Многоходовое редактирование книги ведется с откатом и ветвлением
Не подходит, если
- Книги в формате .xls и .xlsb: они открываются только для чтения
- Нужна работа с живым окном Excel и макросами: инструмент не управляет интерфейсом приложения
- Одна формула на листе: быстрее поправить вручную, чем поднимать сервер
Пример запроса к агенту
Открой budget.xlsx, добавь строку расходов в таблицу на листе Q4 без поломки итогов, пересчитай и покажи, какие ячейки изменились.MCP
- Транспорт
- http, stdio
- Авторизация
- не нужна
Переменные окружения
SPREADSHEET_MCP_WORKSPACE- Рабочая папка с книгами, по умолчанию текущая
SPREADSHEET_MCP_RECALC_ENABLED- Включает инструменты записи и пересчета
SPREADSHEET_MCP_ALLOW_OVERWRITE- Разрешает перезапись исходных файлов в save_fork
Ограничения
Запись и пересчет в MCP-сервере выключены по умолчанию и включаются переменной SPREADSHEET_MCP_RECALC_ENABLED, перезапись исходного файла требует SPREADSHEET_MCP_ALLOW_OVERWRITE. Рабочая папка с книгами задается SPREADSHEET_MCP_WORKSPACE, можно закрепить сервер за одной книгой. Для части сценариев пересчета можно выбрать LibreOffice вместо встроенного движка. Установочный скрипт запускается через curl, прочитайте его до запуска. Описание в README объемное и сильно ориентировано на разработчика, версия на момент проверки 0.16.
Как отключить. Удалите блок agent-spreadsheet из конфигурации клиента, затем cargo uninstall agent-spreadsheet-mcp или brew uninstall agent-spreadsheet. Рабочие книги сервер не хранит, он читает их из заданной папки.
Частые вопросы
Какие файлы поддерживаются?
.xlsx и .xlsm для чтения и записи, .xls и .xlsb только для поиска и чтения. Сохранение исходного файла по умолчанию выключено.
Чем это лучше автоматизации интерфейса?
Агент работает с самой книгой: пересчитывает формулы, видит изменения ячеек и проверяет результат командами verify. Хрупких кликов по окну Excel нет.
Как работает защита изменений?
Есть предпросмотр записи, режимы вывода без перезаписи, сессии с журналом, ветками и откатом, а также анализ структурного влияния до крупной правки.
Какой адрес у MCP-сервера?
По умолчанию HTTP на 127.0.0.1:8079 с точкой POST /mcp и канонической /v1. Транспорт stdio включается переменной SPREADSHEET_MCP_TRANSPORT.
Можно ли использовать без сервера?
Да, CLI asp работает с файлами напрямую, а TypeScript SDK запускает встроенный WASM-движок внутри процесса без сервера.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыoffice-oxide-mcp — Office и PDF для ИИ-агентов
office-oxide-mcp
MCP-сервер на Rust читает и создает Excel, Word, PowerPoint и PDF локально и заполняет формы PDF с вашего подтверждения
MCP-сервер для создания и правки файлов Excel без установленного Microsoft Office: формулы, форматы, графики, сводные таблицы
Excel MCP Server (negokaz) — чтение и запись Excel
Excel MCP Server (negokaz)
MCP-сервер читает и пишет книги Excel: значения, формулы, таблицы, форматирование и новые листы; на Windows умеет делать снимок листа
Пакет Python, CLI и MCP-сервер: книги Excel превращаются в структурированный JSON для LLM, правки идут патчами с пробным запуском
Фреймворк, где агент описывает таблицу на React, а open-sheet собирает живой .xlsx с формулами вместо адресов ячеек.
MCP PDF ebook: агент находит книги в папке и читает EPUB и PDF по главам и страницам, получая оглавление, метаданные и текст в Markdown
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| agent-spreadsheet — Excel для ИИ-агентов (эта карточка) | нет | не нужна | 64 | |
| Excel MCP Server | нет | не нужна | 4 292 | MCP для чтения и записи Excel, без пересчета формул и доказательств изменений |
| ExcelMcp | нет | не нужна | 887 | другой MCP для Excel, отдельная реализация |
Коротко о README
README объясняет три формы продукта и общий движок, перечисляет приемы безопасной правки и проверки, затем идут установка, быстрый старт MCP, таблица переменных окружения и справочник команд CLI.