Об этом проекте

Excel MCP Server — это сервер Model Context Protocol, который даёт ИИ-ассистентам возможность создавать, читать и редактировать книги Excel. Установка Microsoft Excel не требуется. Он работает с файлами .xlsx, .xlsm (макросы сохраняются), .xltx и .xltm. Возможности - Чтение и запись ячеек, формул и дат, с постраничным выводом для больших листов и поиском по ячейкам. - Форматирование шрифтов, заливок, границ, числовых форматов, ширины столбцов и закреплённых областей. - Управление структурой: листы, строки и столбцы, объединённые ячейки, таблицы, диаграммы и сводные таблицы. - Применение правил: условное форматирование и проверка данных, например выпадающие списки и числовые ограничения. - Чтение кода VBA в файлах .xlsm по модулям (только чтение, никогда не выполняется). Функции безопасности - Необязательное ограничение папок через --allow-dir или EXCEL_FILES_PATH; относительные пути разрешаются внутри разрешённых папок. - Проверка безопасности формул отклоняет функции, обращающиеся к сети, другим программам или сведениям о хосте (например, WEBSERVICE, HYPERLINK, IMAGE, RTD, CALL, INFO, INDIRECT), ссылки DDE и внешние ссылки на книги. - Режим только чтения, максимальный размер файла (по умолчанию 100 МБ), лимит в 100 000 ячеек на вызов и атомарное сохранение. - В режиме HTTP сервер по умолчанию слушает localhost; удалённый доступ требует bearer-токена, и рекомендуется обратный прокси с завершением TLS. Настройка Клиенты обычно запускают сервер командой uvx excel-mcp-server stdio, при необходимости с --allow-dir. Документированные интеграции включают Claude Desktop (в том числе пакет .mcpb), Claude Code, Cursor, VS Code с GitHub Copilot, OpenAI Codex, Gemini CLI и Devin Desktop. Доступен режим Streamable HTTP с поддержкой Docker. Области инструментов включают книги (create, describe, list, export, import), листы (describe, create, rename, copy, delete, insert/delete rows or columns), ячейки (read_range, write_range, clear_range, copy_range, find_cells), форматирование (format_range, merge_cells, set_sheet_layout, add_conditional_format, add_data_validation), объекты (create_table, create_chart, create_summary_table) и макросы (read_vba). Ограничения - Формулы сохраняются, но не вычисляются; режим значений возвращает результаты, сохранённые Excel в последний раз, поэтому только что записанные формулы читаются как пустые, пока файл не будет открыт и сохранён в Excel или LibreOffice. - Устаревшие файлы .xls и .csv не поддерживаются. - create_summary_table записывает статическую сводку; настоящие сводные таблицы (PivotTables) не создаются. - Вставка или удаление строк и столбцов не обновляет формулы, диаграммы или таблицы, ссылающиеся на перемещённые ячейки. - Возможности, которые не понимает openpyxl, например фигуры, срезы и некоторые внедрённые объекты, могут быть потеряны при редактировании; изображения, диаграммы, таблицы и макросы в файлах .xlsm сохраняются. В версии 1.0 инструменты переименованы и переработаны, удалён транспорт SSE, требуется Python 3.11 или новее. Лицензия MIT.