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許可證。