用于电子表格分析和编辑的MCP服务器。为LLM代理设计的简洁、令牌高效的工具表面。
概览
它为代理提供了一种安全、可检查且高效的令牌方式，而无需依赖脆弱的UI自动化。 如果你想让经纪人像真实系统一样操作电子表格，而不是像截图木偶一样，这就是这个堆栈。 代理电子表格在三个表面提供统一的电子表格交互层： WASM 构建（agent-spreadsheet-wasm）是SDK的本地运行时，而非独立的产品表面：JS和TypeScript代码针对一个对象模型，执行基底（服务器与嵌入式引擎）是配置选择。 在0.16版本中，这些表面共享Rust文档/评估器运行时和32操作注册表。显式本地会话会自动启动私有日志支持的主机。SDK/WASM和真正的just-bash会话会保留其历史记录;XLSX导出保存文档快照，而非可重启会话日志。温编辑/重新计算/读取循环避免了XLSX序列化和重复计算器摄取。
概述（AI 翻译）
agent-spreadsheet 是用于基于代理的电子表格交互工具。
它为代理提供了一种安全、可检查、高效的令牌方式，阅读、分析、变异、验证和操作Excel工作簿，而无需退回脆弱的UI自动化。
如果你想让经纪人像真实系统一样操作电子表格，而不是像截图木偶一样，这就是这个堆栈。
这个项目是什么
代理电子表格在三个表面提供统一的电子表格交互层：
| 表面 | 二进制 / 封装 | 模式 | 最佳 |
|---|---|---|---|
| CLI | agent-spreadsheet / asp |
无状态文件 + 常驻会话 | 一次性流水线或保留多回合工作簿编辑 |
| MCP 服务器 | agent-spreadsheet-mcp |
有状态 | 多回合代理会话、工作簿缓存、分支/重新计算工作流 |
| TypeScript SDK | agent-spreadsheet-sdk |
库 | 应用集成 — 驱动服务器的规范/v1路由，或通过嵌入的WASM引擎在进程中完全运行（无需服务器） |
本页由 AI 翻译，技术细节请以原文为准。
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
安装
docker run -i --rm -v /path/to/workbooks:/data ghcr.io/psu3d0/agent-spreadsheet-mcp:latest-full --transport stdio配置
{
"mcpServers": {
"spreadsheet": {
"command": "agent-spreadsheet-mcp",
"args": ["--workspace-root", "/path/to/workbooks", "--transport", "stdio"]
}
}
}