psu3d0/agent-spreadsheet

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

63 stars 9 forks Качество 80 Тренд 21Apache-2.0

MCP-сервер для анализа и редактирования электронных таблиц. Слим, токен-эффективная поверхность инструмента, предназначенная для агентов LLM.

Обзор

Это дает агентам безопасный, проверяемый, токен-эффективный способ, не возвращаясь к хрупкой автоматизации пользовательского интерфейса. Если вы хотите, чтобы агент работал с электронными таблицами, как с реальной системой, а не с куклой скриншота, это стек. Agent-spreadsheet представляет собой единый слой взаимодействия электронных таблиц на трех поверхностях: WASM сборка (агент-распространитель-вазм) является локальным временем выполнения SDK, а не отдельной поверхностью продукта: код JS и TypeScript нацелен на одну объектную модель, а подложка исполнения (сервер против встроенного двигателя) является выбором конфигурации. В 0,16 эти поверхности делятся резидентным временем выполнения документа / оценщика Rust и реестром 32 операций. Явные нативные сессии автоматически запускают частный журнал-хостинг. Сессии SDK/WASM и подлинные сессии Just-bash сохраняют свою историю в памяти; экспорт XLSX сохраняет снимок документа, а не перезагружаемый журнал сеансов. Теплые циклы редактирования / пересчета / чтения позволяют избежать сериализации XLSX и повторного приема оценщика.

Обзор (машинный перевод)

Agent-spreadsheet - это сервис взаимодействия с инструментами для использования электронных таблиц на основе агентов.

Это дает агентам безопасный, проверяемый, токен-эффективный способ ** читать, анализировать, мутировать, проверять и эксплуатировать рабочие книги Excel**, не возвращаясь к хрупкой автоматизации пользовательского интерфейса.

Если вы хотите, чтобы агент работал с электронными таблицами, как с реальной системой, а не с куклой скриншота, это стек.

Что это за проект

Agent-spreadsheet представляет собой единый слой взаимодействия электронных таблиц на трех поверхностях:

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

agent-spreadsheet

agent-spreadsheet is the tool interaction service for agent-based spreadsheet usage.

It gives agents a safe, inspectable, token-efficient way to read, analyze, mutate, verify, and operationalize Excel workbooks without falling back to brittle UI automation.

If you want an agent to work with spreadsheets like a real system instead of a screenshot puppet, this is the stack.

What this project is

agent-spreadsheet ships a unified spreadsheet interaction layer across three surfaces:

Surface	Binary / Package	Mode	Best for
CLI	`agent-spreadsheet` / `asp`	Stateless files + resident sessions	One-shot pipelines or retained multi-turn workbook editing
MCP server	`agent-spreadsheet-mcp`	Stateful	Multi-turn agent sessions, workbook caching, fork/recalc workflows
TypeScript SDK	`agent-spreadsheet-sdk`	Library	App integrations — drives the server’s canonical `/v1` route, or runs fully in-process via the embedded WASM engine (no server required)

The WASM build (agent-spreadsheet-wasm) is the SDK’s local runtime, not a separate product surface: JS and TypeScript code targets one object model and the execution substrate (server vs embedded engine) is a configuration choice.

In 0.16 these surfaces share the resident Rust document/evaluator runtime and 32-operation registry. Explicit native sessions automatically start a private journal-backed host. SDK/WASM and genuine just-bash sessions retain their history in memory; XLSX export saves a document snapshot, not a restartable session journal. Warm edit/recalculate/read loops avoid XLSX serialization and repeated evaluator ingestion. See runtime guarantees and limits and the SDK/just-bash examples.

Supported workbook modes:

.xlsx / .xlsm — read + write
.xls / .xlsb — discovery/read-oriented workflows only

Powered by Formualizer

Открыть полный README на GitHub

Установка

docker run -i --rm -v /path/to/workbooks:/data ghcr.io/psu3d0/agent-spreadsheet-mcp:latest-full --transport stdio

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "spreadsheet": {
      "command": "agent-spreadsheet-mcp",
      "args": ["--workspace-root", "/path/to/workbooks", "--transport", "stdio"]
    }
  }
}