powerbi-mcp 0.1.0__tar.gz → 0.1.2__tar.gz

{powerbi_mcp-0.1.0 → powerbi_mcp-0.1.2}/.gitignore

@@ -13,4 +13,6 @@ wheels/
 
 # Agent files
 .playwright-mcp/
-.ref/
+.ref/
+.mcpregistry_registry_token
+.mcpregistry_github_token

{powerbi_mcp-0.1.0 → powerbi_mcp-0.1.2}/CLAUDE.md

@@ -13,8 +13,10 @@ Keep both `README.md` and `DEVELOPER_GUIDE.md` updated with any user-facing or a
 Modular MCP server organized by separation of concerns (~2120 total LOC across 13 files):
 
 ```
-src/
-├── server.py           # Entry point, FastMCP initialization
+powerbi_mcp/
+├── __init__.py        # Main entry point (contains main())
+├── __main__.py        # Module execution support
+├── server.py          # FastMCP initialization
 ├── auth.py            # OAuth2 authentication, token management
 ├── client.py          # PowerBI REST API client
 ├── constants.py       # Configuration values (URLs, timeouts, limits)
@@ -35,7 +37,7 @@ src/
 ```bash
 # Package manager: uv (with .venv virtual environment)
 uv sync                # Install dependencies
-uv run run-server      # Run server (calls src.server:main)
+uv run run-server      # Run server (calls powerbi_mcp:main)
 
 # Development testing with MCP Inspector
 npx @modelcontextprotocol/inspector uv --directory . run run-server
@@ -59,7 +61,7 @@ npx @modelcontextprotocol/inspector uv --directory . run run-server
 
 8. **PowerBI Expertise**: Use the `powerbi-expert` skill for DAX, M language, and data modeling questions.
 
-9. **Version Bumping**: Check if version in `pyproject.toml` needs updating (currently 0.0.1).
+9. **Version Bumping**: Check if version in `pyproject.toml` needs updating (currently 0.1.1).
 
 10. **Commit Message**: Do not add "Co-Authored-By: Claude Sonnet 4.5 noreply@anthropic.com" to commit message.
 

{powerbi_mcp-0.1.0 → powerbi_mcp-0.1.2}/DEVELOPER_GUIDE.md

@@ -98,14 +98,17 @@ When a user runs the server, the following chain of calls happens:
 2. **pyproject.toml** defines the `run-server` script:
    ```toml
    [project.scripts]
-   run-server = "src.server:main"
+   run-server = "powerbi_mcp:main"
    ```
 
-3. **src/server.py** contains the `main()` function:
+3. **powerbi_mcp/__init__.py** contains the `main()` function:
    ```python
    def main():
        """Main entry point for the PowerBI MCP server"""
        import os
+       import logging
+
+       logger = logging.getLogger(__name__)
        transport = os.getenv("MCP_TRANSPORT", "stdio")
        logger.info(f"Starting PowerBI MCP Server via transport: {transport}")
        mcp.run(transport=transport)
@@ -117,7 +120,7 @@ When a user runs the server, the following chain of calls happens:
 
 ### How .env Files Are Loaded
 
-The server loads environment variables from a `.env` file using this logic in `src/auth.py`:
+The server loads environment variables from a `.env` file using this logic in `powerbi_mcp/auth.py`:
 
 ```python
 from dotenv import load_dotenv
@@ -196,14 +199,14 @@ Test the server with actual MCP clients:
 ### Changing Configuration Values
 
 **API Endpoints:**
-Edit `src/constants.py`:
+Edit `powerbi_mcp/constants.py`:
 ```python
 API_BASE_URL = "https://api.powerbi.com/v1.0/myorg"
 AUTH_URL_TEMPLATE = "https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token"
 ```
 
 **Timeouts:**
-Edit `src/constants.py`:
+Edit `powerbi_mcp/constants.py`:
 ```python
 AUTH_TIMEOUT = 30.0  # Authentication request timeout
 API_TIMEOUT = 60.0   # API request timeout
@@ -211,7 +214,7 @@ TOKEN_REFRESH_BUFFER = 60  # Refresh token N seconds before expiry
 ```
 
 **Response Limits:**
-Edit `src/constants.py`:
+Edit `powerbi_mcp/constants.py`:
 ```python
 CHARACTER_LIMIT = 25000      # Max characters in response
 MAX_ROWS_DISPLAY = 100       # Max rows shown in query results
@@ -223,7 +226,7 @@ MIN_WORKSPACES_TOP = 1       # Min workspaces per request
 
 ### Improving Error Messages
 
-All HTTP error handling is in **one place**: `src/exceptions.py`
+All HTTP error handling is in **one place**: `powerbi_mcp/exceptions.py`
 
 **Example: Improve 404 error message**
 ```python
@@ -252,20 +255,20 @@ elif status_code == 404:
 ### Adding New Validation Rules
 
 **For DAX queries:**
-Edit `src/validation.py`:
+Edit `powerbi_mcp/validation.py`:
 ```python
 def validate_dax_query(query: str) -> None:
     """Validate DAX query"""
     if not query.strip().upper().startswith("EVALUATE"):
         raise ValueError("Query must start with EVALUATE")
-    
+
     # Add new validation here:
     if len(query) > 10000:
         raise ValueError("Query too long (max 10000 characters)")
 ```
 
 **For other validations:**
-Add new functions to `src/validation.py`:
+Add new functions to `powerbi_mcp/validation.py`:
 ```python
 def validate_workspace_id(workspace_id: str) -> None:
     """Validate workspace ID format"""
@@ -286,7 +289,7 @@ validate_workspace_id(workspace_id)
 
 **Example: Add "Reports" formatter**
 
-1. Create detail formatter in `src/formatters.py`:
+1. Create detail formatter in `powerbi_mcp/formatters.py`:
 ```python
 def _format_report_details(report: dict[str, Any]) -> list[str]:
     """Format detailed fields for a report"""
@@ -318,7 +321,7 @@ That's it! The generic `_format_items_markdown()` handles:
 
 ### Adding Custom Exception Types
 
-Edit `src/exceptions.py`:
+Edit `powerbi_mcp/exceptions.py`:
 
 ```python
 class RateLimitError(APIError):
@@ -345,14 +348,17 @@ elif status_code == 429:
 
 | Module | Responsibility | What to Put Here |
 |--------|---------------|------------------|
-| `constants.py` | Configuration values | API URLs, timeouts, limits, any hardcoded value |
-| `validation.py` | Input validation | Validation functions that are used in multiple places |
-| `exceptions.py` | Error handling | Custom exceptions, HTTP error mapping |
-| `client.py` | API client | PowerBI REST API interactions only |
-| `auth.py` | Authentication | OAuth2 flow, token management |
-| `formatters.py` | Response formatting | Markdown/JSON formatters |
-| `models.py` | Data models | Pydantic models for request/response |
-| `tools/*.py` | MCP tools | Tool definitions, tool-specific logic |
+| `powerbi_mcp/__init__.py` | Entry point | Main function for server startup |
+| `powerbi_mcp/__main__.py` | Module execution | Enables `python -m powerbi_mcp` |
+| `powerbi_mcp/server.py` | FastMCP initialization | Server setup and tool registration |
+| `powerbi_mcp/constants.py` | Configuration values | API URLs, timeouts, limits, any hardcoded value |
+| `powerbi_mcp/validation.py` | Input validation | Validation functions that are used in multiple places |
+| `powerbi_mcp/exceptions.py` | Error handling | Custom exceptions, HTTP error mapping |
+| `powerbi_mcp/client.py` | API client | PowerBI REST API interactions only |
+| `powerbi_mcp/auth.py` | Authentication | OAuth2 flow, token management |
+| `powerbi_mcp/formatters.py` | Response formatting | Markdown/JSON formatters |
+| `powerbi_mcp/models.py` | Data models | Pydantic models for request/response |
+| `powerbi_mcp/tools/*.py` | MCP tools | Tool definitions, tool-specific logic |
 
 ---
 
@@ -373,6 +379,13 @@ from .validation import validate_dax_query
 from .exceptions import handle_http_error, PowerBIError, APIError
 ```
 
+**For external imports or testing, use absolute imports:**
+```python
+# For external imports or testing, use absolute imports:
+from powerbi_mcp.constants import API_BASE_URL
+from powerbi_mcp.validation import validate_dax_query
+```
+
 **Avoid circular imports:**
 - ✅ `constants.py` has no imports from other modules
 - ✅ `validation.py` has no imports from other modules
@@ -386,13 +399,13 @@ from .exceptions import handle_http_error, PowerBIError, APIError
 
 **Test constants:**
 ```python
-from src.constants import API_TIMEOUT
+from powerbi_mcp.constants import API_TIMEOUT
 assert API_TIMEOUT == 60.0
 ```
 
 **Test validation:**
 ```python
-from src.validation import validate_dax_query
+from powerbi_mcp.validation import validate_dax_query
 import pytest
 
 # Valid query
@@ -405,7 +418,7 @@ with pytest.raises(ValueError):
 
 **Test error handling:**
 ```python
-from src.exceptions import handle_http_error
+from powerbi_mcp.exceptions import handle_http_error
 import httpx
 
 # Mock HTTP 404 error
@@ -417,8 +430,8 @@ assert "404" in str(exception)
 
 **Test formatters:**
 ```python
-from src.formatters import format_workspaces_markdown
-from src.models import DetailLevel
+from powerbi_mcp.formatters import format_workspaces_markdown
+from powerbi_mcp.models import DetailLevel
 
 workspaces = [{"id": "123", "name": "Test WS"}]
 output = format_workspaces_markdown(workspaces, DetailLevel.CONCISE)
@@ -686,9 +699,9 @@ test: add integration tests for datasets
 
 3. **Make changes**
    - Follow the module responsibilities (see above)
-   - Add constants to `constants.py`
-   - Add validation to `validation.py`
-   - Update error handling in `exceptions.py`
+   - Add constants to `powerbi_mcp/constants.py`
+   - Add validation to `powerbi_mcp/validation.py`
+   - Update error handling in `powerbi_mcp/exceptions.py`
    - Implement features in appropriate modules
 
 4. **Test changes**

{powerbi_mcp-0.1.0 → powerbi_mcp-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: powerbi-mcp
-Version: 0.1.0
+Version: 0.1.2
 Summary: Model Context Protocol server for PowerBI REST API integration
 Project-URL: Homepage, https://github.com/gurvinder-dhillon/powerbi-mcp
 Project-URL: Documentation, https://github.com/gurvinder-dhillon/powerbi-mcp#readme
@@ -31,6 +31,8 @@ Description-Content-Type: text/markdown
 [![Python Versions](https://img.shields.io/pypi/pyversions/powerbi-mcp.svg)](https://pypi.org/project/powerbi-mcp/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+<!-- mcp-name: io.github.gurvinder-dhillon/powerbi-mcp -->
+
 A Model Context Protocol (MCP) server that provides tools for interacting with PowerBI REST APIs. This server enables AI assistants like Claude to query PowerBI workspaces, datasets, and execute DAX queries.
 
 > [!WARNING]

{powerbi_mcp-0.1.0 → powerbi_mcp-0.1.2}/README.md

@@ -4,6 +4,8 @@
 [![Python Versions](https://img.shields.io/pypi/pyversions/powerbi-mcp.svg)](https://pypi.org/project/powerbi-mcp/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+<!-- mcp-name: io.github.gurvinder-dhillon/powerbi-mcp -->
+
 A Model Context Protocol (MCP) server that provides tools for interacting with PowerBI REST APIs. This server enables AI assistants like Claude to query PowerBI workspaces, datasets, and execute DAX queries.
 
 > [!WARNING]

powerbi_mcp-0.1.2/powerbi_mcp/__init__.py

@@ -0,0 +1,25 @@
+"""
+PowerBI MCP Server
+
+A Model Context Protocol server for interacting with PowerBI REST API.
+"""
+
+__version__ = "0.1.2"
+__author__ = "Gurvinder Dhillon"
+__description__ = "MCP server for PowerBI REST API interactions & run DAX queries."
+
+from .server import mcp
+
+
+def main():
+    """Main entry point for the PowerBI MCP server"""
+    import os
+    import logging
+
+    logger = logging.getLogger(__name__)
+    transport = os.getenv("MCP_TRANSPORT", "stdio")
+    logger.info(f"Starting PowerBI MCP Server via transport: {transport}")
+    mcp.run(transport=transport)
+
+
+__all__ = ["mcp", "main"]

powerbi_mcp-0.1.2/powerbi_mcp/__main__.py

@@ -0,0 +1,12 @@
+"""
+Entry point for running powerbi-mcp as a module.
+
+This allows the package to be run with:
+- python -m powerbi_mcp
+- uvx powerbi-mcp
+"""
+
+from powerbi_mcp import main
+
+if __name__ == "__main__":
+    main()

{powerbi_mcp-0.1.0/src → powerbi_mcp-0.1.2/powerbi_mcp}/server.py

@@ -76,15 +76,3 @@ register_workspace_tools(mcp)
 register_dataset_tools(mcp)
 register_query_tools(mcp)
 logger.info("All tools registered")
-
-
-def main():
-    """Main entry point for the PowerBI MCP server"""
-    import os
-    transport = os.getenv("MCP_TRANSPORT", "stdio")
-    logger.info(f"Starting PowerBI MCP Server via transport: {transport}")
-    mcp.run(transport=transport)
-
-
-if __name__ == "__main__":
-    main()

{powerbi_mcp-0.1.0 → powerbi_mcp-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "powerbi-mcp"
-version = "0.1.0"
+version = "0.1.2"
 description = "Model Context Protocol server for PowerBI REST API integration"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"
@@ -26,14 +26,15 @@ dependencies = [
 ]
 
 [project.scripts]
-run-server = "src.server:main"
+powerbi-mcp = "powerbi_mcp:main"
+run-server = "powerbi_mcp:main"
 
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src"]
+packages = ["powerbi_mcp"]
 
 [project.urls]
 Homepage = "https://github.com/gurvinder-dhillon/powerbi-mcp"

powerbi_mcp-0.1.2/server.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.gurvinder-dhillon/powerbi-mcp",
+  "title": "PowerBI MCP Server",
+  "description": "MCP server for PowerBI REST API integration. Query workspaces, datasets, and execute DAX queries through natural language.",
+  "repository": {
+    "url": "https://github.com/gurvinder-dhillon/powerbi-mcp",
+    "source": "github"
+  },
+  "version": "0.1.2",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "powerbi-mcp",
+      "version": "0.1.2",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "POWERBI_TENANT_ID",
+          "description": "Azure AD Tenant ID for PowerBI authentication",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": false
+        },
+        {
+          "name": "POWERBI_CLIENT_ID",
+          "description": "Azure AD Application (Client) ID with PowerBI API access",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": false
+        },
+        {
+          "name": "POWERBI_CLIENT_SECRET",
+          "description": "Azure AD Client Secret for service principal authentication",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}

{powerbi_mcp-0.1.0 → powerbi_mcp-0.1.2}/uv.lock

@@ -301,7 +301,7 @@ wheels = [
 
 [[package]]
 name = "powerbi-mcp"
-version = "0.0.1"
+version = "0.1.1"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

powerbi_mcp-0.1.0/src/__init__.py

@@ -1,13 +0,0 @@
-"""
-PowerBI MCP Server
-
-A Model Context Protocol server for interacting with PowerBI REST API.
-"""
-
-__version__ = "0.1.0"
-__author__ = "PowerBI MCP Contributors"
-__description__ = "MCP server for PowerBI REST API integration"
-
-from .server import mcp
-
-__all__ = ["mcp"]