pbix-mcp 0.2.0__tar.gz

pbix_mcp-0.2.0/.coveragerc

@@ -0,0 +1,14 @@
+[run]
+source = src/pbix_mcp
+branch = true
+omit =
+    tests/*
+    */__pycache__/*
+
+[report]
+show_missing = true
+fail_under = 25
+exclude_lines =
+    pragma: no cover
+    if __name__ == .__main__.
+    pass

pbix_mcp-0.2.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,63 @@
+name: Bug Report
+description: Report something that isn't working correctly
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug!
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Describe what went wrong. Include error messages if any.
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. Create a PBIX with ...
+        2. Call pbix_create with ...
+        3. Open in PBI Desktop ...
+    validations:
+      required: true
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: Category
+      options:
+        - PBIX Creation (builder)
+        - Data Sources (CSV/SQLite/SQL Server/MySQL/PostgreSQL)
+        - DirectQuery
+        - DAX Evaluation
+        - Report Layout / Visuals
+        - DataModel Read/Write
+        - File Open/Save
+        - MCP Server
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: pbix-mcp version
+      placeholder: "0.2.0"
+
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: "3.12"

pbix_mcp-0.2.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,46 @@
+name: Feature Request
+description: Suggest an improvement or new capability
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Have an idea to make pbix-mcp better? We'd love to hear it!
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What would you like?
+      description: Describe the feature or improvement.
+    validations:
+      required: true
+
+  - type: textarea
+    id: use_case
+    attributes:
+      label: Use case
+      description: How would you use this? What problem does it solve?
+    validations:
+      required: true
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: Category
+      options:
+        - New data source type
+        - New DAX function
+        - New data type
+        - Report creation / builder
+        - MCP tool
+        - Performance
+        - Documentation
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Have you tried any workarounds?

pbix_mcp-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package and dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Lint with ruff
+        run: ruff check src/ tests/
+
+      - name: Type check with mypy (baseline 149 errors, fail if new errors added)
+        shell: bash
+        run: |
+          COUNT=$(mypy src/pbix_mcp/ --ignore-missing-imports --no-error-summary 2>&1 | grep -c "error:" || true)
+          echo "mypy errors: $COUNT (baseline: 149)"
+          if [ "$COUNT" -gt 149 ]; then
+            echo "FAIL: mypy errors ($COUNT) exceed baseline (149)"
+            exit 1
+          fi
+
+      - name: Run unit tests with coverage
+        run: pytest -m "not slow and not integration" -v --tb=short --cov=src/pbix_mcp --cov-report=term-missing --cov-fail-under=28
+
+      - name: Build package
+        run: python -m build
+
+      - name: Verify wheel installs cleanly
+        run: |
+          pip install dist/*.whl --force-reinstall --no-deps
+          python -c "from pbix_mcp.server import mcp; print('Import OK')"

pbix_mcp-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,67 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pbix-mcp
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true

pbix_mcp-0.2.0/.gitignore

@@ -0,0 +1,30 @@
+__pycache__/
+*.pyc
+*.pyo
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.env
+.venv
+venv/
+test_samples/*.pbix
+!test_samples/.gitkeep
+# Generated PBIX files (keep templates and fixtures)
+*.pbix
+!src/pbix_mcp/templates/*.pbix
+!tests/fixtures/pbix/*.pbix
+*.abf
+*.tmp
+*.bak
+.claude/
+*.so
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+test_samples/temp_dl/
+.coverage
+test_corpus/
+tools/

pbix_mcp-0.2.0/CHANGELOG.md

@@ -0,0 +1,59 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2026-03-23
+
+### Added
+- **DirectQuery mode**: `mode='directquery'` creates live database connections (SQL Server verified with LocalDB)
+- **SQL Server data source**: `source_db={'type': 'sqlserver', ...}` for Import and DirectQuery
+- **SQLite data source**: `source_db={'type': 'sqlite', ...}` with ODBC driver
+- **MySQL data source**: `source_db={'type': 'mysql', ...}` (same M pattern as SQL Server)
+- **CSV refreshable sources**: `source_csv` parameter creates M expressions for Refresh in PBI Desktop
+- **Boolean data type**: full support (IsOperatingOn32=1, 0/1 values)
+- **Decimal data type**: full support (value × 10000, IsOperatingOn32=1)
+- **NoSplit<N> encoder**: reverse-engineered binary format for R$ relationship INDEX and H$ hierarchy tables
+- **R$ relationship system tables**: cross-table RELATED() and filtering work in PBI Desktop
+- **H$ attribute hierarchy tables**: NoSplit<32> POS_TO_ID/ID_TO_POS for DAX dimension support
+- **RowNumber AttributeHierarchy**: fixes MDNaiveCoordCell::InitPrototype assertion
+- **Template neutralization**: template external file references auto-neutralized on build
+- Example scripts in `examples/` directory
+
+### Fixed
+- Compression class IDs fully reverse-engineered from xmsrv.dll via Ghidra (u32_a/u32_b selectors)
+- DictionaryStorage.IsOperatingOn32=1 for Int64/Decimal/Boolean (was causing PFE_FILESTORE_CORRUPTION)
+- Double column support: added "Double" to encoder type mappings
+- DirectQuery detection: Mode=1 (not Type=6 which is PolicyRange)
+- SMS.Type=2 for H$ tables (was 3, causing DBCC_SEGMENT_CORRUPT)
+- Zero-division error when building tables with 0 distinct values
+
+## [0.1.0] - 2026-03-20
+
+### Added
+- Initial release as installable Python package (`pip install -e .`)
+- 60 MCP tools for full PBIX/PBIT read/write access
+- `pbix_create`: build PBIX files from scratch with actual row data
+- `pbix_add_visual` / `pbix_remove_visual`: visual management
+- `pbix_get_rls_roles` / `pbix_set_rls_role` / `pbix_evaluate_rls`: Row-Level Security (beta)
+- `pbix_get_password`: extract embedded passwords (beta)
+- `pbix_doctor`: 8-point diagnostic health check (beta)
+- DAX evaluation engine with 156 functions (best-effort evaluator)
+- Calculated table support (DATATABLE, GENERATESERIES, CALENDAR, field parameters)
+- Calculated column evaluation (beta; per-row DAX expressions)
+- Auto-applied default slicer filters from report layout (legacy + PBIR)
+- Smart SELECTEDVALUE/ISFILTERED fallback for parameter-driven measures
+- VertiPaq table data read/write (String, Int64, Double, DateTime, Decimal)
+- XPress9 DataModel decompress/recompress (byte-exact round-trip)
+- ABF archive build from scratch / manipulation
+- PBIXBuilder: programmatic PBIX creation with row data
+- Pydantic response models (ToolResponse, DAXEvalResponse, DAXResult)
+- Typed exception hierarchy (errors.py with 12 exception classes)
+- Diagnostic logging (normal/debug/trace via PBIX_MCP_LOG_LEVEL or --log-level)
+- CI pipeline for Python 3.10-3.13 (ruff, mypy, pytest, coverage)
+- ~163 passing tests from fresh clone, ~8 skip without private files
+- 19 cross-report integration tests (require private PBIX corpus)
+- Public PBIX fixtures (basic_layout, basic_measures)
+- SUPPORT.md, CONTRIBUTING.md, issue templates

pbix_mcp-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,66 @@
+# Contributing
+
+## Setup
+
+```bash
+git clone https://github.com/d0nk3yhm/pbix-mcp.git
+cd pbix-mcp
+pip install -e ".[dev]"
+```
+
+## Running Tests
+
+```bash
+# Fast unit tests only (~163 pass from fresh clone, ~8 skip without test corpus)
+pytest -m "not slow"
+
+# Download public test corpus, then run integration tests
+python scripts/download_test_corpus.py
+PBIX_TEST_SAMPLES=test_corpus pytest -v
+
+# With coverage
+pytest --cov=src/pbix_mcp --cov-report=term-missing -m "not slow"
+```
+
+## Code Style
+
+- Linting: `ruff check src/ tests/`
+- Type checking: `mypy src/pbix_mcp/`
+
+## Project Layout
+
+```
+src/pbix_mcp/
+  server.py              # MCP server (60 tools)
+  cli.py                 # Entry point (pbix-mcp-server --log-level debug)
+  builder.py             # PBIX file builder (create from scratch with row data)
+  errors.py              # Typed exceptions with stable error codes (12 classes)
+  logging_config.py      # Diagnostic logging (normal/debug/trace)
+  dax/
+    engine.py            # DAX evaluator (156 functions, best-effort)
+    calc_tables.py       # Calculated table + column support
+  formats/
+    abf_rebuild.py       # ABF archive format (read, modify, build from scratch)
+    datamodel_roundtrip.py  # XPress9 compress/decompress
+    vertipaq_encoder.py  # VertiPaq column encoding (5 data types)
+  models/
+    requests.py          # Tool input models (FilterContext, DimensionRef)
+    responses.py         # Tool output models (ToolResponse, DAXEvalResponse)
+tests/
+  test_dax_engine.py     # Unit tests (55; 6 skip without private files)
+  test_dax_accuracy.py   # Accuracy tests (50)
+  test_golden.py         # Golden tests (15; 2 skip without private files)
+  test_fixtures.py       # Fixture tests (18; ships with repo)
+  test_beta_features.py  # Beta feature tests (10; RLS, password, doctor)
+  test_cross_report.py   # Integration tests (19; requires 4 private PBIX files)
+```
+
+## Commit Messages
+
+Use conventional format:
+- `feat:` new feature or tool
+- `fix:` bug fix
+- `refactor:` code restructure without behavior change
+- `test:` test additions
+- `docs:` documentation only
+- `chore:` build/CI changes

pbix_mcp-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hans
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE 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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.