Bilig WorkPaper Server

社区

供代理使用的工作簿公式读回、输入编辑、JSON持久化与风险预检

分类: 其他第 25 / 230
Stars: ★ 35 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 22+ · 远程托管（无需本地环境）
凭据: 无需凭据
许可证: MIT
最近提交: 17 天前
工具数: 8

67FMRS · C

Bilig WorkPaper 为代理和Node服务提供了一种独特的方式来处理支持公式的工作簿，而无需使用电子表格UI。它提供了验证过的读写回和JSON持久化，对实现定价/审批自动化的工作流很有用。然而，它并不声称完全兼容Excel，其准确性依赖于自身的公式引擎。

最强项 · 文档质量 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

14/20

维护活跃度

14/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: manifest 未列出具体工具，README 声称的工具集(list_sheets、read_range、set_cell_contents、analyze_workbook_risk 等)无法与源码或提交测试核对；README 与 npm 元数据属不可信证据。声称 CI、CodeQL、Scorecard 徽章但未提供可核查的测试覆盖该 server 关键路径的证据，按规则不给高于 12；happy path 描述合理但边界与错误处理证据不足，扣分至 10。
安全与权限 14/20: 未发现恶意行为、凭据窃取或隐蔽外传；formula clinic 声明不上传工作簿，远程端点为公开 JSON-only。但写文件(--writable)覆盖持久化文件、远程 hosted endpoint 的数据边界与确认机制在源材料中未展示，权限与确认细节不完整，扣至 14。
维护活跃度 14/20: 版本 0.164.11 显示高频发版，MIT 许可、SECURITY.md、SLSA provenance、OpenSSF Scorecard 均有提及；但 star 35、open issues 0，无法验证 issue 响应与真实维护节奏，静态审查仅见声明，扣至 14。
文档质量 16/20: README 分层详尽，含安装、评估路径、限制披露(如 Excel 兼容性边界、excelParity not_proven)、排错路径与安全政策，质量高；但大量内容面向整个 monorepo 而非被评审的 server，且工具参数说明未在源材料中给出，扣至 16。
安装易用性 13/20: 提供 npm 包、stdio 传输、远程 streamable-http URL、MCPB bundle 及多 host 配置示例，安装路径清晰；但主流客户端的具体 JSON 配置片段未在源材料中直接呈现，且未提供可核查的运行证据，扣至 13。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

需要后端工作簿计算、无需可视界面的Node.js服务
需要工具以公式读回与计算单元格值交互的AI代理

不适合谁

需要图形电子表格界面或Office宏的用例
要求与Excel完全兼容的流程

所需权限

读写工作簿输入和公式
若要持久化，需对指定WorkPaper JSON文件的写权限
托管模式无需授权即可

风险与副作用

公式兼容性有限；可能存在未被支持的公式
基于文件模式中的持久化可能导致意外覆盖
嵌入的XLSX公式缓存值可能不够准确；未与Excel结果交叉检查

安装接入

准备工作

运行环境：Node.js 22+ · 远程托管（无需本地环境）

使用npm运行本地服务器：npm exec --package @bilig/workpaper@latest -- bilig-workpaper-mcp。对于托管HTTP端点，可使用 https://bilig.proompteng.ai/mcp。使用前，请检查npm包是否有SLSA来源证明：npm view @bilig/workpaper version dist.attestations --json。

验证是否装好

运行 npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --，当返回 verified: true 且客户端工具列表中出现 list_sheets、read_range、set_cell_contents 等工具时，即证明 MCP 服务器连接成功。

常见排障

验证Node版本 >= 22
使用`bilig-formula-clinic`检查公式支持
确保未尝试访问挂载的XLSX文件

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出当前工作簿的所有工作表。
读取 Inputs!B2 单元格的值，然后把它的值改为 32 并读回依赖公式 Summary!B2 的计算结果。
验证 Summary!B7 中的公式是否有效，并显示它的计算结果。
导出当前 WorkPaper 的 JSON 文档。

工具能力 8

list_sheets 只读

列出工作簿中的所有工作表

read_range 只读

从指定单元格范围读取值（公式或计算值）

read_cell 只读

读取单元格内容

set_cell_contents 写入

设置单元格内容（公式或值）

set_cell_contents_and_readback 写入

设置单元格并读取重计算的值

get_cell_display_value 只读

获取单元格的显示值

export_workpaper_document 只读

导出整个WorkPaper JSON文档

validate_formula 只读

验证公式语法

使用场景

当代理需要读取和修改由公式驱动的工作簿（如定价或报价计算）时

自动化带有依赖公式的工作流审批决策

将工作簿状态持久化为JSON以进行审计或复原

支持客户端

Claude Desktop

Generic MCP Client

依据项目文档列出，未经本站实测。

详细介绍

Bilig WorkPaper 服务器面向需要以编程方式处理电子表格公式的AI代理和Node.js服务。它允许代理创建或加载工作簿（WorkPaper JSON），编辑输入单元格，重新计算公式，读取计算后的输出，并持久化更改。该服务器支持工作簿公式的业务规则，如定价、报价审批、支出检查和导入验证。它拥有无头、无需Excel的处理能力，并提供诸如 read_range 和 set_cell_contents_and_readback 等工具，以便带有前后计算值的单元格操作。它提供两种部署方式：本地stdio封装（用于持久化项目WorkPaper JSON），以及无状态HTTP端点（用于快速测试）。它不声称完全兼容Excel。

同仓库的其他 Server

源版本 49db26b4bcaa 数据同步于 2026-10-19 查看 FMRS 评分方法