@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

$3

Add this to your Claude Desktop config and restart:

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

$3

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

`json
{
"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

$3

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:
`bash
export DATAFLINT_CUSTOMER_DOMAIN="your-company-name"
`

Via config file (~/.dataflint/config.json):
`json
{
"customerDomain": "your-company-name"
}
`

$3

For custom self-hosted deployments or testing:

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

Installation

$3

`bash


Run directly with npx (recommended)

npx @dataflint/mcp-server --help

Or install globally

npm install -g @dataflint/mcp-server
dataflint-mcp --help
`

$3

`bash
npm install @dataflint/mcp-server
`

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

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

$3

`bash
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.