Power BI模型文档生成工具

一个用于为Power BI语义模型生成全面、标准化文档的Claude技能工具,支持交互式配置和多格式输出。

  • by MaartenKesters
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 MaartenKesters/powerbi-mcp-documentation

使用说明

📊 powerbi-mcp文档

Claude为Power BI语义模型生成全面、标准化文档的技能。专为配合使用而设计 Claude.ai 和那个 powerbi-modeling-mcp 服务器。


📁 此存储库中有什么

powerbi-mcp-documentation/
└── SKILL.md        # The skill definition file used by Claude

这 SKILL.md 该文件包含指导Claude完成文档过程的所有指令、工作流逻辑、格式规则和输出模板。


⚡ 快速开始

先决条件

  • A. Claude.ai 帐户(专业版或团队版推荐)
  • 这 powerbi建模mcp 在Claude中安装并连接MCP服务器
  • 要连接的正在运行的Power BI Desktop实例、PBIP文件夹或结构工作区

安装

  1. 克隆或下载此存储库。
  2. 在Claude.ai,去你的 项目设置 并添加 SKILL.md 将文件作为项目文档,或在系统提示中引用它。
  3. 确保 powerbi-modeling-mcp 服务器处于活动状态,并列在您连接的MCP工具下。

用法

加载技能后,只需让Claude记录您的模型:

Document this Power BI model
Generate documentation for my semantic model
Create a Power BI documentation report

Claude将连接到您的语义模型,收集元数据,并在生成最终输出之前引导您完成交互式配置过程。


✨ 特性

交互式、有指导的工作流程 Claude一次只问一个配置问题,不需要预先填写长表格。你可以控制记录的内容。

两个文档预设+手动模式

  • 内部预设 --全面、技术性,包括所有DAX代码和建议
  • 客户端预设 --精致、以业务为中心、技术细节较少
  • 手动模式 --单独配置每个部分

业务上下文上传 在生成之前上传现有文档(需求、数据字典、利益相关者简报、维基页面)。Claude使用此上下文编写更丰富的、特定于领域的描述和摘要。

您可以包含或跳过的部分

  • 执行摘要
  • 数据源(带Power Query M代码)
  • 可视化ER图(导出为 .mermaid 文件)
  • 关系概述
  • 表(按类型分组:事实、维度、参数、其他)
  • 度量值(按显示文件夹分组)
  • 计算组
  • 建议(Kimball方法+Power BI最佳实践)
  • 业务术语表

Word文档输出 最终文档是样式化的 .docx 具有一致标题、表和代码块的文件——准备与利益相关者共享或保存到项目wiki。

美人鱼ER图 一个单独的 .mermaid 该文件与Word文档一起生成,可以在GitHub、Notion或任何兼容Mermaid的查看器等工具中呈现。


📄 输出文件

文档运行后,Claude将提供:

文件 描述
[ModelName]_Documentation.docx 主要文档Word文档
[ModelName]_DataModel.mermaid 实体关系图(如果选择)

🔧 需求

要求 详细信息
Claude Claude.ai专业版、团队版或企业版
MCP服务器 powerbi-modeling-mcp
Power BI 桌面、PBIP文件夹或结构工作区