适合谁
- 需要精确单元格地址和读回结果的场景
- Node后端服务中的公式化业务逻辑
- 需要JSON持久化的工作簿应用
B
57FMRS · C
Bilig WorkPaper MCP服务器将公式计算能力带入AI代理和Node服务，支持输入编辑、公式重算、JSON持久化，并提供MCP工具界面。它与官方MCP注册表集成，提供stdio和远程HTTP端点。该服务器不是官方维护，但在文档中提供了充分的验证路径。
Bilig WorkPaper是一个MCP服务器，为代理提供公式工作簿的读写和重算能力。它允许代理编辑输入单元格、读取由公式计算的输出、将工作簿状态持久化为JSON，并支持通过MCP工具进行工作簿风险预检。专为需要与结构化公式工作簿交互的Node服务和AI代理设计。
工具能力
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
分析工作簿的导入/导出风险。
安装接入
使用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"
]
}
}
}
选型与风险
不适合谁
- 可视化电子表格编辑
- 宏或Office自动化
- 一次性简单算术计算
所需权限
- 读取和写入工作簿单元格
- 导出JSON文件（本地或远程）
风险与副作用
- 公式兼容性有限，不支持所有Excel函数
- 嵌入式XLSX缓存值可能不准，需以Excel重算为基准
常见排障
- 使用bilig-evaluate --door agent-mcp验证MCP连接
- 检查Node版本>=22
- 确保工作簿文件路径正确
使用场景
AI代理自动编辑电子表格输入并读取计算结果
Node服务中的定价模型、报价审批、工资计算
CI/CD测试中验证公式正确性
工作流自动化中保存和恢复工作簿状态
支持客户端
Claude Desktop完整支持
OpenAI Agents SDK完整支持
n8n完整支持