# Agent Spreadsheet MCP

Даёт агентам безопасный доступ к файлам Excel: умеет читать таблицы, править ячейки и пересчитывать формулы без запуска офисных пакетов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 62
- Автор: PSU3D0
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/PSU3D0/agent-spreadsheet
- Обновлён: 2026-09-09
- HTML: https://affpapa.org/nevibecode/mcp/agent-spreadsheet-mcp

## Что делает

Сервер работает на базе движка Formualizer, написанного на Rust. Он рассчитывает граф зависимостей и выполняет свыше 400 формул Excel прямо в памяти, поэтому агенту не нужны запущенный Excel COM или LibreOffice.

Внутри реализовано версионирование сессий с ветвлением и сухими прогонами (dry-run). Агент может проверить результат расчётов через сверку разницы (diff) и доказательство вычислений до того, как итоговый файл запишется на диск.

Файлы `.xls` и `.xlsb` сервер только читает, поэтому перезаписать старый бинарный формат без предварительной конвертации в `.xlsx` или `.xlsm` не выйдет. Для запуска серверной части в рекомендованной конфигурации потребуется Docker.

## Требования
- Нужно: Docker

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add agent-spreadsheet-mcp -- docker run -i --rm ghcr.io/psu3d0/agent-spreadsheet:0.16.0-full
```

### Codex

**Командой платформы**
```bash
codex mcp add agent-spreadsheet-mcp -- docker run -i --rm ghcr.io/psu3d0/agent-spreadsheet:0.16.0-full
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent-spreadsheet-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/psu3d0/agent-spreadsheet:0.16.0-full"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent-spreadsheet-mcp": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/psu3d0/agent-spreadsheet:0.16.0-full"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add agent-spreadsheet-mcp docker run -i --rm ghcr.io/psu3d0/agent-spreadsheet:0.16.0-full
```

## Когда брать
- пересчитать формулы и зависимости внутри книги Excel
- дописать данные в таблицу без риска повредить разметку
- проверить диффы и результаты расчёта перед сохранением файла
- проанализировать структуру старых бинарных книг xls и xlsb

## Примеры запросов агенту
- Открой бюджет в `financials.xlsx`, добавь новую строку расходов и пересчитай итоговые суммы.
- Покажи разницу в формулах между ветками расчёта в таблице `model.xlsx` перед сохранением.
- Проанализируй структуру листа и диапазон именованных ячеек в файле `report.xlsx`.

## Похожие
- [Excel MCP Server](https://affpapa.org/nevibecode/mcp/excel-mcp-server.md) — MCP-сервер · ★ 4259
- [kordoc](https://affpapa.org/nevibecode/mcp/kordoc.md) — MCP-сервер · ★ 2726
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP-сервер · ★ 1247
- [Microsoft 365 MCP Server](https://affpapa.org/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP-сервер · ★ 1074
- [anymd](https://affpapa.org/nevibecode/mcp/anymd.md) — MCP-сервер · ★ 1051
- [Docling MCP](https://affpapa.org/nevibecode/mcp/docling-mcp.md) — MCP-сервер · ★ 777

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md