@dataflint/mcp-server

DataFlint MCP Server - Model Context Protocol server for Apache Spark optimization and analysis.

Quick Start

Configuration file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

For SaaS customers:

Add this to your Claude Desktop config and restart:

{
  "mcpServers": {
    "dataflint": {
      "command": "npx",
      "args": [
        "-y",
        "@dataflint/mcp-server@latest"
      ]
    }
  }
}

For BYOC (bring your own cloud) customers:

If your organization has a custom DataFlint deployment, add your domain:

{
  "mcpServers": {
    "dataflint": {
      "command": "npx",
      "args": [
        "-y",
        "@dataflint/mcp-server@latest",
        "--customer-domain",
        "YOUR_COMPANY_NAME"
      ]
    }
  }
}

Replace "YOUR_COMPANY_NAME" with your organization name (e.g., "acme-corp").

What happens: Browser opens for login, credentials saved locally, then you can ask Claude to analyze your Spark jobs!

Configuration Details

Customer Domain

The --customer-domain flag automatically configures:

• Your organization's Auth0 authentication
• Your organization's API endpoint
• All required authentication settings

Alternative configuration methods:

Via environment variable:

export DATAFLINT_CUSTOMER_DOMAIN="your-company-name"

Via config file (~/.dataflint/config.json):

{
  "customerDomain": "your-company-name"
}

Advanced Options

For custom self-hosted deployments or testing:

dataflint-mcp \
  --server-url https://your-server.com \
  --auth-domain your-auth.auth0.com \
  --client-id YOUR_CLIENT_ID

Installation

As CLI Tool

# Run directly with npx (recommended)
npx @dataflint/mcp-server --help

# Or install globally
npm install -g @dataflint/mcp-server
dataflint-mcp --help

As Library

npm install @dataflint/mcp-server

import {
  DataFlintCopilotMcpServer,
  DataFlintServerService
} from '@dataflint/mcp-server';

const server = new DataFlintCopilotMcpServer(/* ... */);

Alternative: Claude CLI

claude mcp add --transport stdio dataflint -- npx -y @dataflint/mcp-server@latest

Troubleshooting

Error: "Unknown customer domain"

Your organization isn't registered yet. Contact DataFlint support or check that you spelled the domain correctly.

Verifying your configuration:

Check the MCP server logs for configuration details:

[CONFIG] Customer domain detected: your-company-name
[CONFIG] Using customer-specific configuration
[CONFIG]   - Server URL: https://api.your-company-name.dataflint.io

License

MIT License - see LICENSE for details.