xlsx-audit-mcp

Name: xlsx-audit-mcp
Author: arose26

本地服务

github.com/arose26数据与分析02 周前更新

代码仓库

关于 xlsx-audit-mcp

xlsx-audit-mcp 是用于审计 Excel 工作簿公式和模型风险的 MCP 服务，面向需要检查电子表格的审核者。它可追踪依赖关系并发现脆弱结构，文件仅在本地处理。

主要功能

01查看工作表、尺寸和公式概况
02按地址列出公式及缓存值
03追踪单元格的前置项和依赖项
04生成工作簿风险排序报告
05检测循环引用和公式风险

适用场景

01追踪单元格的输入来源及后续影响
02检查财务模型中的脆弱公式
03定位外部链接和易变函数

MCP 相关

向 MCP 客户端提供工作簿检查、公式追踪和审计工具。它处理本地文件，不会将文件传出设备。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "arose26-xlsx-audit": {
      "command": "npx",
      "args": [
        "-y",
        "xlsx-audit-mcp"
      ]
    }
  }
}

启动命令npx -y xlsx-audit-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmxlsx-audit-mcp0.1.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
path	string	是	.xlsx 工作簿的路径

详细介绍

xlsx-audit-mcp

一个用于审计 Excel 工作簿的 MCP 服务。其他 Excel MCP 服务会读取和写入数据，而这个服务会审查你的模型：

“Summary 工作表上的 Total 单元格由什么提供数据？”——追踪前置单元格
“如果我更改这个假设，哪些内容会出问题？”——追踪后续单元格，包括通过 SUM(A1:A40) 这类范围使用该单元格的内容
“审计这个工作簿”——检查循环引用并给出示例链、易变函数（INDIRECT、OFFSET、NOW、RAND……）、公式中隐藏的硬编码常量、外部工作簿链接、合并单元格和超长公式

电子表格中的错误出了名地代价高昂。这项服务将审计人员手动执行的“追踪前置单元格”流程开放给大模型，让其一次审查整个工作簿。仅处理本地文件；不会有任何内容离开你的设备。

快速开始

Claude Code

claude mcp add xlsx-audit -- npx -y xlsx-audit-mcp

Claude Desktop——添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "xlsx-audit": {
      "command": "npx",
      "args": ["-y", "xlsx-audit-mcp"]
    }
  }
}

然后输入：“审计 C:\models\budget-2026.xlsx，告诉我哪些地方看起来脆弱。”

工具

工具	功能
`workbook_overview`	工作表、维度、公式数量、定义的名称、外部链接
`list_formulas`	显示公式、地址和缓存值，可按条件筛选（`INDIRECT`、`VLOOKUP`……）
`trace_cell`	查看单元格的公式、值、前置单元格和后续单元格（直接引用和通过范围引用）
`audit_workbook`	生成整个模型的风险排序报告

工作原理

引用分词器能够理解真实公式：先剥离字符串字面量（INDIRECT("A1") 中的 "A1" 不是引用），避免函数名冲突（LOG10(...) 中的 G10 不是单元格），并处理 $ 绝对引用、带引号的工作表名称（'My Data'!A1）和范围。
共享公式会展开。 Excel 使用偏移方案仅存储一次填充公式；加载器会按单元格转换公式（相对引用随之偏移，绝对引用保持不变），因此依赖关系查询可以看到每个单元格实际计算的内容。
存储时绝不展开范围——后续单元格查询使用范围包含测试；循环检测会限制范围扇出（SUM(A:A) 不会导致图膨胀；受限范围会被报告，不会被静默忽略）。
不计算公式。 显示文件中的缓存值，不依赖电子表格引擎。

已知限制：R1C1 表示法和结构化表格引用（[@Column]）会计数，但不会解析到图中。

开发

npm install
npm test                 # offline tests — synthetic workbooks built in-suite
npm run build            # tsc → dist/
node scripts/smoke.mjs   # end-to-end: generates a workbook, drives the server over stdio

架构：src/xlsx.ts（zip + XML → 工作簿模型）和 src/formulas.ts（分词器、图、风险特征）是纯逻辑；src/index.ts 负责 MCP 接线。