Tabular MCP

🚀 表格MCP服务器（又名MCPBI）

这是一个用于本地运行表格模型（即运行在PowerBI桌面版上的PowerBI模型）的模型上下文协议（MCP）服务器。该服务器允许支持MCP的大语言模型（LLM）客户端与你的表格模型进行通信，帮助你调试、分析和编写DAX查询。

示例：Copilot通过MCP查询表格模型

🚀 快速开始

运行原理

它使用ADOMD.NET中的AdomdConnection连接到本地运行的表格模型实例。借助此连接，服务器允许客户端执行DAX查询，并通过预定义工具高精度地检索模型元数据（使用DMV查询），同时也支持用于调试和开发的自定义DAX查询。

该MCP服务器通过ADOMD.NET实现客户端与Power BI表格模型之间的通信，既支持预定义的元数据查询，也支持具备完整DEFINE块功能的灵活DAX查询，以进行高级分析。

✨ 主要特性

工具

• ListMeasures：列出模型中所有度量的基本信息（名称、表、数据类型、可见性），可选择按表名进行过滤。如需完整的DAX表达式，请使用GetMeasureDetails。
• GetMeasureDetails：按名称获取特定度量的详细信息。
• ListTables：列出模型中的所有表。
• GetTableDetails：按名称获取特定表的详细信息。
• GetTableColumns：按名称获取特定表的列信息。
• GetTableRelationships：按名称获取特定表的关系信息。
• PreviewTableData：预览表中的数据（前N行）。
• RunQuery：执行DAX查询。支持包含DEFINE块、EVALUATE语句的完整DAX查询或简单表达式。
• ValidateDaxSyntax：验证DAX语法并通过增强的错误分析识别潜在问题。
• AnalyzeQueryPerformance：分析查询性能特征并识别潜在瓶颈。

📦 安装指南

系统要求和安装说明

请参阅了解系统要求和安装说明。

快速启动a) 使用预构建的可执行文件

为了最快完成设置，你可以使用Releases部分的预构建可执行文件。

1. 配置Power BI连接：

   Releases\pbi-local-mcp.DiscoverCli.exe
   

   按照提示检测你的Power BI实例并创建.env文件。
2. 配置VS Code MCP集成： 使用以下内容配置mcp.json：

{ "mcpServers": { "MCPBI": { "command": "C:\dir\to\mcpbi.exe", "args": [] } } }

### 快速启动b) 将端口作为参数
或者，如果你已经知道PowerBI表格模型运行的端口（例如从Tabular Editor中可见），可以使用以下内容配置`mcp.json`：
```json
{
 "mcpServers": {
   "MCPBI": {
     "command": "C:\\dir\\to\\mcpbi.exe",
     "args": ["--port","12345"]
   }
 }
}

📚 详细文档

请参阅进行测试相关操作。

📄 许可证

本项目采用MIT许可证。