mkdir pbix-mcp-server
cd pbix-mcp-server

pip install -r requirements.txt

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pbix-server": {
      "command": "python",
      "args": ["C:\\pbix-mcp-server\\pbix_server.py"]
    }
  }
}

• ✅ Modification directe des mesures DAX sans outils externes
• ✅ Lecture simple du modèle de données
• ✅ Import/Export de mesures en JSON
• ✅ Sauvegardes automatiques avant modifications
• ✅ Compatible Git - idéal pour le contrôle de version
• ✅ Pas besoin de Power BI Desktop pour les modifications simples

MonProjet.pbip/              # Dossier du projet
├── MonProjet.pbip           # Fichier principal (métadonnées)
├── MonProjet.Report/        # Dossier du rapport
│   ├── report.pbir          # Définition du rapport
│   └── definition/          # Visuels et pages
│       ├── pages/
│       └── ...
└── MonProjet.SemanticModel/ # Dossier du modèle sémantique
    ├── definition.pbidataset # 🎯 Modèle de données (Tables, Mesures)
    ├── model.bim            # Modèle Analysis Services
    └── ...

1. load_pbip - Charge un projet PBIP
2. list_pbip_structure - Liste la structure du projet
3. backup_pbip - Crée une sauvegarde

1. read_datamodel_definition - Lit le modèle de données
2. list_tables - Liste toutes les tables
3. list_dax_measures - Liste les mesures DAX (avec filtre optionnel)
4. read_report_definition - Lit la définition du rapport

1. add_dax_measure - Ajoute une nouvelle mesure
2. update_dax_measure - Modifie une mesure existante
3. delete_dax_measure - Supprime une mesure

1. export_measures_to_json - Exporte toutes les mesures en JSON
2. import_measures_from_json - Importe des mesures depuis JSON

load_pbip C:\Projets\MonProjet.pbip

load_pbip C:\Projets\MonProjet.pbip\

list_dax_measures

list_dax_measures table_filter="Ventes"

add_dax_measure 
  measure_name="Total Ventes"
  dax_expression="SUM(Ventes[Montant])"
  table_name="Mesures"
  description="Somme totale des ventes"
  format_string="#,##0.00 €"
  display_folder="KPI Ventes"

update_dax_measure
  measure_name="Total Ventes"
  table_name="Mesures"
  new_expression="SUMX(Ventes, Ventes[Quantité] * Ventes[PrixUnitaire])"
  new_description="Calcul actualisé du total"

delete_dax_measure
  measure_name="Mesure Obsolete"
  table_name="Mesures"

export_measures_to_json C:\Projets\mes_mesures.json

import_measures_from_json C:\Projets\mes_mesures.json

{
  "measures": [
    {
      "table": "Mesures",
      "name": "Total Ventes",
      "expression": ["SUM(Ventes[Montant])"],
      "description": "Somme totale des ventes",
      "formatString": "#,##0.00 €",
      "displayFolder": "KPI Ventes"
    },
    {
      "table": "Mesures",
      "name": "Nombre Clients",
      "expression": ["DISTINCTCOUNT(Ventes[ClientID])"],
      "description": "Nombre de clients uniques",
      "formatString": "#,##0",
      "displayFolder": "KPI Clients"
    }
  ]
}

# Clone du projet
git clone https://github.com/team/powerbi-project.git
cd powerbi-project


# Charger le projet
load_pbip MonProjet.pbip


# Ajouter des mesures
add_dax_measure ...


# Commit et push
git add .
git commit -m "Ajout de nouvelles mesures DAX"
git push

# Exporter depuis le projet source
load_pbip ProjetSource.pbip
export_measures_to_json mesures_communes.json


# Importer dans le projet cible
load_pbip ProjetCible.pbip
import_measures_from_json mesures_communes.json

# Charger le projet
load_pbip MonProjet.pbip


# Créer une sauvegarde manuelle
backup_pbip


# Faire des modifications
add_dax_measure ...
update_dax_measure ...


# Une sauvegarde auto est créée avant chaque modification

• ✅ Créer une table dédiée "Mesures" pour toutes les mesures
• ✅ Utiliser display_folder pour organiser par catégorie
• ✅ Toujours ajouter une description claire
• ✅ Définir le format d'affichage approprié

// ✅ BON
Total Ventes
CA par Client
Croissance % YoY


// ❌ MAUVAIS
tv
chiffre_affaires_divise_par_nombre_clients
croissance

• ✅ Utiliser Git pour versionner le projet PBIP
• ✅ Exporter les mesures en JSON pour la documentation
• ✅ Créer des branches pour tester de nouvelles mesures
• ✅ Faire des commits atomiques par fonctionnalité

• ❌ Format PBIP uniquement - Ne fonctionne pas avec PBIX
• ⚠️ Pas de validation DAX - Le serveur ne vérifie pas la syntaxe
• ⚠️ Modification manuelle - Power BI doit recharger le fichier
• ⚠️ Pas de gestion des relations - Seulement les mesures DAX

1. Toujours créer une sauvegarde avant modifications importantes
2. Tester les mesures dans Power BI après ajout
3. Fermer Power BI avant de modifier le fichier manuellement
4. Rouvrir Power BI après les modifications pour recharger

pip install mcp pydantic

{
  "mcpServers": {
    "pbip-server": {
      "command": "python",
      "args": ["C:\\chemin\\vers\\pbip_server.py"]
    }
  }
}

{
  "mcpServers": {
    "pbip-server": {
      "command": "python3",
      "args": ["/chemin/vers/pbip_server.py"]
    }
  }
}

# 1. Ouvrir le PBIX dans Power BI Desktop
# 2. Fichier > Enregistrer sous > Format PBIP
# 3. Charger le PBIP avec le serveur MCP
load_pbip MonProjet.pbip

{
  "measures": [
    {
      "table": "Mesures",
      "name": "Total {METRIC}",
      "expression": ["SUM({TABLE}[{COLUMN}])"],
      "formatString": "#,##0.00 €"
    }
  ]
}

# Script de test des mesures
import json


# Exporter les mesures
export_measures_to_json("measures.json")


# Vérifier la syntaxe, conventions de nommage, etc.
with open("measures.json") as f:
    measures = json.load(f)
    
for measure in measures["measures"]:
    # Vérifications...
    assert measure["description"], f"Pas de description: {measure['name']}"

• Documentation PBIP Microsoft
• Format PBIP sur GitHub
• Guide DAX
• Power BI Community

• ✅ Modifications programmatiques directes
• ✅ Collaboration facilitée via Git
• ✅ Automatisation des tâches répétitives
• ✅ Réutilisation de composants entre projets