Tableau Workbook Auditor

tableau-lineage-mcp

让 AI 助手读取 Tableau 工作簿中的血缘关系，同时确保工作簿始终留在你的设备上。

一个 MCP 服务，可解析本地 Tableau 工作簿（.twbx / .twb），并向 Claude、Cursor 和其他 MCP 客户端提供 11 个工具：完整的工作簿审计（未使用字段、重复计算、性能问题）、两个版本之间的语义差异，以及每个计算字段、参数、筛选器、工作表、仪表板和已存储 SQL 语句的完整血缘关系。

它采用的正是为 tableau-lineage.com 提供支持的开源提取引擎，并将其封装起来供 AI 助手使用。解析在你的设备上通过进程内方式完成：无需上传、无需服务器、无需账户。读取 .twbx 时，只会解压工作簿 XML，绝不会触碰其中捆绑的数据提取文件。

你可以向助手提什么问题

• “审计 ~/Downloads/Sales.twbx。哪些内容可以安全删除？”
• “这个仪表板的 v3 和 v4 之间有什么变化，会造成什么影响？”
• “[Profit Ratio] 依赖哪些字段？”
• “这个工作簿为什么运行缓慢？”
• “哪些工作表按 Region 筛选，选中了哪些值？”
• “为这个工作簿编写一份数据字典。”

安装

Claude Desktop（一键安装，无需终端）

下载扩展，然后双击。Claude Desktop 会为你完成安装。 无需安装 Node，也无需配置文件，因为 Claude Desktop 自带 Node。

你也可以将 .mcpb 拖到 Claude Desktop 窗口中，或使用 设置 → 扩展 → 高级设置 → 安装扩展。

Claude Code

claude mcp add tableau-lineage -- npx -y tableau-lineage-mcp

Claude Desktop（手动安装，适合偏好配置文件而非扩展的用户）

将以下内容添加到 claude_desktop_config.json（设置 → 开发者 → 编辑配置）：

{
  "mcpServers": {
    "tableau-lineage": {
      "command": "npx",
      "args": ["-y", "tableau-lineage-mcp"]
    }
  }
}

Cursor / 其他 MCP 客户端

任何支持 stdio MCP 服务的客户端都可以使用同一条命令：npx -y tableau-lineage-mcp。

需要 Node.js 18+。

工具

工具	功能
audit_workbook	未使用的字段和参数（按置信度分级并附理由）、重复计算，以及包含严重性等级和修复建议的性能问题
diff_workbooks	两个版本之间的语义差异：新增、删除、重命名或编辑的计算（每项编辑都附带受影响的下游字段），以及参数、筛选器、工作表、仪表板、数据源和 SQL 的差异
analyze_workbook	概览：统计信息、数据源、按类型分类的计算字段、参数、原始字段
list_calculated_fields	每个计算的公式、类型和直接依赖项；可选子字符串筛选
get_field	单个字段的完整详情，包括所有直接使用该字段的内容
trace_dependencies	上游树（追溯至原始列和参数），以及传递性下游影响
list_parameters	参数的值、数据类型、允许值，以及使用这些参数的字段
get_lineage_graph	以节点和边的 JSON 形式提供完整依赖图
list_sql_queries	自定义 SQL（完整查询文本）、Initial SQL、带参数的存储过程引用，以及 RAWSQL_* 计算；每项均附带其目标连接
list_filters	跨工作表去重后的所有筛选器：字段、类型、上下文筛选器状态、成员选择和范围，以及 by_worksheet 分类明细
list_worksheets	每个工作表及其使用的字段（已解析标题）和应用的筛选器

所有工具都需要传入本地 .twbx 或 .twb 文件的 path。字段名称不区分大小写，方括号可省略：Profit Ratio 和 [profit ratio] 都能匹配。

隐私政策

完整政策：https://github.com/andey0Saikiran/tableau-lineage/blob/main/PRIVACY.md

收集内容：无。 此服务不会发出任何网络请求。它只会读取你明确传入的工作簿路径，在你的机器上以内存方式解析，并将结果返回给启动它的 MCP 客户端。它不会读取你的其他文件、对话历史或助手的记忆，也不会向磁盘写入任何内容。

存储与保留：无。 工作簿数据仅在调用期间保存在内存中，并在进程退出时丢弃。没有服务端、数据库或日志记录。

第三方：无。 请注意，工具调用的结果（字段名称、公式、审计结果）会返回给你选择提问的 AI 助手，以便它回答你；你的工作簿文件本身绝不会被发送到任何地方。该对话受你所用助手自身的隐私政策约束。

联系方式： https://github.com/andey0Saikiran/tableau-lineage/issues · 安全问题报告：https://github.com/andey0Saikiran/tableau-lineage/security/advisories/new

工作原理

• 工作簿从你的本地磁盘读取，并在 Node 进程中解析。不会向任何地方发送内容。
• 未使用的字段会被列为带有置信度的候选项，绝不会作为保证安全的删除清单：工作簿文件无法证明某个字段在任何地方都未被引用。删除任何内容前，请先阅读原因。
• 对于 .twbx 包，只会解压 .twb XML 条目。打包的数据提取文件（.hyper / .tde）会被完全跳过。
• 不进行分析、不使用遥测，也不会发出任何网络请求。

由于此软件包是开源的，你可以在代码中核实以上所有内容。

更喜欢使用 UI？

同一引擎也可通过免费 Web 应用运行：tableau-lineage.com：拖入 .twbx 文件，即可获取审计结果、交互式血缘关系图、可搜索的数据字典和版本对比，所有处理 100% 都在浏览器中完成。

开发

git clone https://github.com/andey0Saikiran/tableau-lineage
cd tableau-lineage/mcp
npm install
npm test        # builds, then runs an end-to-end JSON-RPC smoke test

许可证

MIT © Sai Kiran Andey