fabric_mcp

This MCP server provides a natural language interface to a Microsoft Fabric GraphQL endpoint.

• Test Connection: specific tool to verify connectivity and auth.
• Execute Query: Runs GraphQL queries against the configured Fabric endpoint.
• Reporting & Visualization:
• CSV Reports: generate_csv_report
• Excel Reports: generate_excel_report (Rich formatting)
• Charts: visualize_data (Bar, Line, Scatter, Pie)

The easiest way to get started is to install the package and its dependencies using the provided installer.

This will install the server in editable mode and generate configuration templates.

python install.py

pip install -r requirements.txt
pip install -e .

After installation, you must configure the server with your Microsoft Fabric GraphQL endpoint details.

The installer generates template snippets:

• COPILOT_CONFIG_SNIPPET.json for GitHub Copilot.
• GEMINI_CONFIG_SNIPPET.json for Gemini.

Required Environment Variables:

• FABRIC_GRAPHQL_ENDPOINT: Your Microsoft Fabric GraphQL API endpoint URL.
• FABRIC_TOKEN (Optional): A direct access token (Bearer token).
• If provided, this is used for the Authorization header.
• If NOT provided, the server attempts to use DefaultAzureCredential.

Copy the configured snippet into your client's settings.

Add the snippet to your ~/.copilot/mcp-config.json (User-level) or .copilot/mcp-config.json (Repository-level).

{
  "mcpServers": {
    "fabric-graphql": {
      "command": "python",
      "args": ["-m", "fabric_mcp.server"],
      "env": {
        "FABRIC_GRAPHQL_ENDPOINT": "https://<your-fabric-endpoint>/graphql",
        "FABRIC_TOKEN": "<your-access-token>"
      }
    }
  }
}