iflow-mcp_data-goblin-fabric-model-reader-mcp 0.1.0
MCP server for reading and analyzing Fabric semantic models
Requires Python: >=3.8

# Fabric Model Reader MCP

[![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![MCP Server](https://img.shields.io/badge/MCP%20Server-Compatible-green.svg)](https://github.com/anthropics/mcp)
[![DXT](https://img.shields.io/badge/DXT-Compatible-orange.svg)](https://github.com/anthropics/dxt)
[![PBIR](https://img.shields.io/badge/PBIR-Compatible-blue.svg)](https://learn.microsoft.com/en-us/power-bi/developer/projects/projects-report?tabs=desktop#definitionpbir)
[![License](https://img.shields.io/badge/license-Non--Commercial-red.svg)](LICENSE)

MCP server for reading and analyzing Fabric semantic models. Available as standalone server and Desktop Extension (DXT).

**Requires authentication to access Power BI workspaces (Azure CLI or Personal Access Token).**

## Quick Start

### For Claude Desktop Users (Easiest)

**Prerequisites**: 
1. Python 3.8+ must be installed and in your PATH
   - **Mac/Linux**: Usually pre-installed as `python3`. Use the `_python3` version.
   - **Windows**: Download from [python.org](https://python.org) - during installation, check "Add Python to PATH". Use the `_python` version.

2. Install required Python packages:
   ```bash
   # For Mac/Linux:
   pip3 install fastmcp requests keyring
   
   # For Windows:
   pip install fastmcp requests keyring
   ```

**Installation**:
1. Download appropriate `.dxt` file from releases
2. Double-click to install in Claude Desktop
3. Configure authentication (see Authentication section)

### For Other MCP Clients

1. Install dependencies:
```bash
pip install -r requirements.txt
```

2. Configure your MCP client to use this server. Example for VS Code:
```json
{
  "mcpServers": {
    "fabric-model-reader": {
      "command": "python3",
      "args": ["path/to/fabric-model-reader-mcp.py"]
    }
  }
}
```

3. Authenticate using one of the supported methods:
- Personal Access Token
- Azure CLI

4. Start using the server through your MCP client.

5. For enhanced functionality, use with related MCP servers:
   - [Fabric Workspace Reader MCP](https://github.com/data-goblin/fabric-workspace-reader-mcp): Explore workspaces and discover resources
   - [Fabric Report MCP](https://github.com/data-goblin/fabric-report-mcp): Manage report lifecycle and content manipulation

### Authentication
The extension supports three authentication methods:
- **Azure CLI**: `az login` (recommended)
- **Environment Variable**: Set `POWERBI_TOKEN`
- **System Keyring**: Store token securely in system keyring

## Available Tools

### get_model_definition
Get the TMDL definition of a semantic model with pagination and filtering support.

**Parameters:**
- `workspace_id` (required): The workspace ID
- `dataset_id` (required): The dataset/semantic model ID
- `file_filter` (optional): Filter for specific files (e.g., 'measures', 'tables/', 'relationships.tmdl')
- `page` (optional): Page number for pagination. Use either page or file_range, not both.
- `page_size` (optional, default: 10): Number of files per page
- `metadata_only` (optional, default: false): If true, returns only file paths without content
- `file_range` (optional): File range to retrieve (e.g., '1-10', '11-20'). Use either page or file_range, not both.

**Example usage:**
```
# Get files 1-10 using file range (recommended for complete retrieval)
get_model_definition(workspace_id="...", dataset_id="...", file_range="1-10")

# Get files 11-20
get_model_definition(workspace_id="...", dataset_id="...", file_range="11-20")

# Get first page of model definition
get_model_definition(workspace_id="...", dataset_id="...")

# Get only measures with file range
get_model_definition(workspace_id="...", dataset_id="...", file_filter="measure", file_range="1-5")

# View all available files without content
get_model_definition(workspace_id="...", dataset_id="...", metadata_only=true)

# Navigate to specific page
get_model_definition(workspace_id="...", dataset_id="...", page=2, page_size=15)
```

### execute_dax_query
Execute a DAX query against a Power BI dataset.

**Parameters:**
- `workspace_id` (required): The workspace ID
- `dataset_id` (required): The dataset/semantic model ID
- `query` (required): The DAX query to execute

**Example usage:**
```
execute_dax_query(
    workspace_id="...", 
    dataset_id="...", 
    query="EVALUATE SUMMARIZECOLUMNS('Product'[Category], \"@TotalSales\", SUM('Sales'[Amount]))"
)
```

## How to Contribute

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Make your changes following the existing patterns
4. Test your changes with sample models
5. Commit your changes (`git commit -m 'Add amazing feature'`)
6. Push to the branch (`git push origin feature/amazing-feature`)
7. Open a Pull Request

## License

This project is licensed under a Non-Commercial License. See [LICENSE](LICENSE) for details.

## Troubleshooting

### Common Issues

**Authentication failures:**
- Run `az login` to authenticate with Azure CLI
- Verify you have access to the target Power BI workspace
- Check that POWERBI_TOKEN environment variable is set correctly

**Model access denied:**
- Ensure you have read permissions for the semantic model
- Verify the workspace ID and dataset ID are correct
- Check that the model is published and accessible

**Large model performance:**
- Use file filtering to focus on specific TMDL components
- Implement pagination for models with many files
- Use metadata_only option to browse structure before downloading content


## Security & Privacy Disclaimer

This software was created by me for me. I am sharing it for educational and personal use.

THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. THE USER ASSUMES ALL RESPONSIBILITY AND RISK FOR THE USE OF THIS SOFTWARE.

**DATA SECURITY AND PRIVACY**: This extension accesses Microsoft Fabric and Power BI data using your provided credentials. The author assumes NO responsibility for data security, privacy, or confidentiality. Users are SOLELY responsible for:
- Protecting their authentication credentials
- Ensuring compliance with their organization's data policies
- Managing access to sensitive or confidential data
- Any data breaches or unauthorized access resulting from use of this extension

By using this code, you acknowledge that you are fully responsible for all data security and privacy implications.

## AI Disclaimer

The code and docs in this repo were generated with the help of Claude Sonnet 4, Claude Opus 4, and Gemini 2.5 Pro using various agentic coding tools.

## General Disclaimer

THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. THE USER ASSUMES ALL RESPONSIBILITY AND RISK FOR THE USE OF THIS SOFTWARE.