Bilig WorkPaper

社区

在Node服务中运行公式工作簿，支持输入编辑、公式重算和JSON持久化。

分类: 开发工具第 158 / 438
Stars: ★ 35 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js >=22.0.0 · Docker · 远程托管（无需本地环境）
凭据: 无需凭据
许可证: MIT
最近提交: 17 天前
工具数: 8

57FMRS · C

Bilig WorkPaper MCP服务器将公式计算能力带入AI代理和Node服务，支持输入编辑、公式重算、JSON持久化，并提供MCP工具界面。它与官方MCP注册表集成，提供stdio和远程HTTP端点。该服务器不是官方维护，但在文档中提供了充分的验证路径。

最强项 · 维护活跃度 14/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

13/20

维护活跃度

14/20

文档质量

10/20

安装易用性

10/20

查看各项评分依据

可靠性 10/20: 仓库README提供了大量可复现的评估命令、CI徽章（Forgejo/GitHub Actions、CodeQL）以及工具清单（list_sheets、read_range、set_cell_contents等），但针对本评分对象packages/headless/server.的npm包@bilig/headless本身没有提交的测试证据或工具级行为说明；README中绝大多数证明、evaluator与文档都指向兄弟包@bilig/workpaper，按规则不能归入本服务器。声明工具与真实行为的一致性仅依赖不可信的README描述，静态审查无法验证，故按'happy path可信但测试/边界证据不可归属'给10分。
安全与权限 13/20: 无恶意行为迹象：本地stdIO优先、公式诊断不上传工作簿内容、依赖npm签名与SLSA provenance、有SECURITY.md与OpenSSF Scorecard。远程端点bilig.proompteng.ai/mcp为无状态JSON-only端点，但manifest同时暴露远程HTTP与本地stdio，数据边界（工作簿内容发往远程服务器的泄露面）未在manifest层面说明；--writable模式会写回同一文件且文档提及，但无确认机制描述。未见红线风险，扣分在于权限/写操作确认与远程数据流披露不完整，给13分。
维护活跃度 14/20: 版本0.164.11显示高频发布节奏，MIT许可明确，有SECURITY.md、SUPPORT.md、贡献指南、讨论区、OpenSSF Scorecard、CodeQL与CI流水线。但本次审查仅获得README快照，未见具体提交频率、issue响应时间与依赖更新证据；版本号极度膨胀(0.164.x)也使版本治理语义模糊。综合给14分。
文档质量 10/20: README极其详尽：安装、评估路径、工具列表、兼容性限制（专门文档说明'哪里还不兼容Excel'）、故障排查与fixture提交流程。但大部分内容与证明属于兄弟包@bilig/workpaper，针对headless/server.这一服务器的安装配置、工具参数schema与限制并未单独成文；文档数量庞大反而增加了定位实际被评分服务器的成本。给10分。
安装易用性 10/20: 存在manifest（npm stdio + 远程streamable-http两种方式），README有npm exec一键验证与MCPB bundle、多宿主配置文件，安装路径表面清晰。但主要安装示例指向@bilig/workpaper而非manifest声明的@bilig/headless，二者关系未澄清；远程端点需要自担数据外发风险。未提供执行证据，保守给10分。

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

查看 FMRS 评分方法 →

选型与风险

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

适合谁

需要精确单元格地址和读回结果的场景
Node后端服务中的公式化业务逻辑
需要JSON持久化的工作簿应用

不适合谁

可视化电子表格编辑
宏或Office自动化
一次性简单算术计算

所需权限

读取和写入工作簿单元格
导出JSON文件（本地或远程）

风险与副作用

公式兼容性有限，不支持所有Excel函数
嵌入式XLSX缓存值可能不准，需以Excel重算为基准

安装接入

准备工作

运行环境：Node.js >=22.0.0 · Docker · 远程托管（无需本地环境）

使用npm包@bilig/headless通过stdio启动服务器，或者使用远程Streamable HTTP端点https://bilig.proompteng.ai/mcp。配置MCP客户端时，在配置文件中添加上述JSON。

claude_desktop_config.json

{
  "mcpServers": {
    "bilig-workpaper": {
      "command": "npx",
      "args": [
        "-y",
        "@bilig/headless"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "bilig-workpaper": {
      "command": "npx",
      "args": [
        "-y",
        "@bilig/headless"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add bilig-workpaper -- npx -y @bilig/headless

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端的工具列表中应能看到 read_cell、set_cell_contents、export_workpaper_document 等工具；也可运行 npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --，输出 verified: true 即表示连接正常。

常见排障

使用bilig-evaluate --door agent-mcp验证MCP连接
检查Node版本>=22
确保工作簿文件路径正确

试试这样问

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

读取 Inputs!B2 和 Summary!B2 两个单元格的当前值
把 Inputs!B3 改成 120，然后回读 Summary!B3 重新计算后的值
把当前工作簿导出为 WorkPaper JSON 文档
分析这个工作簿的公式风险并给出报告

工具能力 8

read_range 只读

读取指定范围的单元格值。

read_cell 只读

读取单个单元格的值。

set_cell_contents 写入

设置单元格的内容并触发公式重算。

set_cell_contents_and_readback 写入

设置单元格内容并读回相关公式结果。

get_cell_display_value 只读

获取单元格的显示值。

export_workpaper_document 写入

将工作簿导出为JSON文档。

validate_formula 只读

验证公式的语法和正确性。

analyze_workbook_risk 只读

分析工作簿的导入/导出风险。

使用场景

AI代理自动编辑电子表格输入并读取计算结果

Node服务中的定价模型、报价审批、工资计算

CI/CD测试中验证公式正确性

工作流自动化中保存和恢复工作簿状态

支持客户端

Claude Desktop

OpenAI Agents SDK

n8n

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

详细介绍

Bilig WorkPaper是一个MCP服务器，为代理提供公式工作簿的读写和重算能力。它允许代理编辑输入单元格、读取由公式计算的输出、将工作簿状态持久化为JSON，并支持通过MCP工具进行工作簿风险预检。专为需要与结构化公式工作簿交互的Node服务和AI代理设计。

同仓库的其他 Server

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

Bilig WorkPaper

选型与风险

适合谁

不适合谁

所需权限

风险与副作用

安装接入

准备工作

验证是否装好

常见排障

试试这样问

工具能力 8

使用场景

支持客户端

详细介绍

同类可选方案

同仓库的其他 Server