关于 SumOffice — real Word and Excel for agents
SumOffice 是供 Agent 使用的 MCP 服务,可读取和编辑 Word 文档与 Excel 工作簿,同时保留原文件。修改先以提案形式呈现,获批准后才应用,并在响应中列出操作步骤。
主要功能
- 01读取和搜索 Word 文档与工作簿
- 02应用前先提出修改方案
- 03检查宏和 Power Query 定义
- 04保存副本并导出 PDF
适用场景
- 01审阅 .docx 并批准替换内容
- 02检查工作簿数据并提出表格修改
- 03检查宏或 Power Query,但不执行
- 04将编辑后的文档导出为 PDF
MCP 相关
通过远程 Streamable HTTP 端点或本地 stdio 服务,向 MCP 客户端提供文档和电子表格工具。提案与应用操作分开,写入前须经批准。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://view.sumoffice.com/mcpclaude mcp add --transport http com-sumoffice-office https://view.sumoffice.com/mcp{"mcpServers":{"com-sumoffice-office":{"type":"http","url":"https://view.sumoffice.com/mcp"}}}在 Cursor 中打开{"servers":{"com-sumoffice-office":{"type":"http","url":"https://view.sumoffice.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-sumoffice-office":{"type":"http","url":"https://view.sumoffice.com/mcp"}}}{"mcpServers":{"com-sumoffice-office":{"serverUrl":"https://view.sumoffice.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
21| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| slug | enum | 是 | footnotes | comments | forms | rtl | wild-horse | workshop | workbook | functions | macros | queries | gep | vba-web | sqlite | order-desk | onrr | cashflow | offer | pivot | chart | notes | check | tools | xtools |
详细介绍
SumOffice MCP 服务 — 为 Agent 提供真正的 Word 和 Excel
一个服务,两种运行方式。Agent 打开你的.docx / .xlsx / .xlsm,读取文件并提出修改建议;你批准后,文件会完好无损地返回 — Excel 和 Word 打开结果时不会弹出修复对话框。宏(VBA)和 Power Query 会随文件一同保留。
注册表名称:com.sumoffice/office · 含实测证明的页面:https://sumoffice.com/mcp · 镜像:docker.io/hissih/sumoffice-mcp
远程 — 无需安装
https://view.sumoffice.com/mcp(streamable HTTP)。
claude mcp add --transport http sumoffice https://view.sumoffice.com/mcp
不支持 HTTP 的客户端:npx -y mcp-remote https://view.sumoffice.com/mcp(参见 examples/)。
通过 stdio 本地运行 — 使用本地文件路径
docker run -i --rm -v "$PWD:/work" hissih/sumoffice-mcp
服务在你的计算机上运行,并在 document_open_file 中接受 path(仅限 /work 下的路径)。文件本身会在 SumOffice 服务上的私有、短时编辑会话中打开,并在会话结束后删除;文件中的任何内容都不会执行。
工具
| 文档(.docx) | 电子表格(.xlsx/.xlsm/.xlsb) | 两者通用 |
|---|---|---|
document_open_file、document_open、document_describe、document_read、document_find、document_comments、document_propose_replacement → document_apply | sheet_describe、sheet_read、sheet_find、sheet_propose_edits → sheet_apply、macro_list、macro_read_source、macro_plan、query_list、query_explain、workbook_inspect | document_save_copy、document_export_pdf |
propose_* 不会写入文件:它会返回差异,供用户或客户端审批;*_apply 会准确应用对应提案。每个步骤都会列在响应中,因此 Agent 无法悄无声息地修改文件。
示例
examples/claude-desktop.json— Claude Desktop(claude_desktop_config.json),通过 Docker 使用本地 stdio。examples/cursor-mcp.json— Cursor(.cursor/mcp.json),远程 HTTP。examples/claude-code.sh— Claude Code,两种运行方式均有示例。examples/docker-compose.yml— 将本地服务作为 compose 服务运行,并挂载文件夹。
暂不支持的功能
- 每份文档同一时间只能有一个编辑会话;第二个 Agent 访问同一文件时将获得只读权限。
- Power Query 定义会保留,但不会在服务会话中刷新。
- 宏会被读取并进行分流(判断哪些将以原生方式运行,哪些留在 Excel 中);MCP 服务不会执行宏。
限制与隐私
免费使用,无需账号。远程服务:每个地址有每日配额;文件会在会话结束后删除,最长不超过 24 小时,且绝不会用于其他用途。详情:https://sumoffice.com/app-privacy.html
许可证
本仓库(文档、清单、示例)采用 MIT 许可证。服务镜像可免费用于评估和公共端点;在组织内部用于生产环境需按应用获取许可证 — https://sumoffice.com/download#server。问题请联系:[email protected]
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。