Icerhymers Uc MCP Proxy Uc MCP Proxy

uc-mcp-proxy: Connect Claude to Databricks MCP Servers

What It Does

uc-mcp-proxy is a stdio-to-Streamable-HTTP bridge. MCP clients like Claude Desktop and Claude Code speak stdio — but Databricks MCP servers speak HTTP. The proxy sits between them and injects a fresh Databricks OAuth token on every request.

Install

# Run directly (recommended — no install needed)
uvx uc-mcp-proxy --url <MCP_SERVER_URL>

# Or install globally
uv tool install uc-mcp-proxy

Requires Python 3.10+.

Databricks MCP Server Types

Configure in Claude Code / Claude Desktop

Add to your .mcp.json (project-level) or ~/.claude/mcp.json (global):

{
  "mcpServers": {
    "my-service": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "uc-mcp-proxy",
        "--url", "https://<workspace>/api/2.0/mcp/functions/main/default"
      ]
    }
  }
}

For Databricks Apps (OAuth required):

{
  "mcpServers": {
    "my-app": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "uc-mcp-proxy",
        "--url", "https://<workspace>.databricks.com/apps/<app-name>/mcp",
        "--auth-type", "databricks-cli"
      ]
    }
  }
}

CLI Flags

Authentication

The proxy uses the Databricks SDK for auth — it auto-detects the method from your environment, or you can force one with --auth-type.

Databricks Apps require OAuth. PAT auth will fail with a 401. Always use --auth-type databricks-cli or OAuth for Apps.

Set Up Databricks CLI Auth

# Install Databricks CLI
pip install databricks-cli
# or
brew install databricks/tap/databricks

# Configure auth (interactive)
databricks configure

# Or set env vars
export DATABRICKS_HOST=https://your-workspace.azuredatabricks.net
export DATABRICKS_TOKEN=your-pat-token

To use a named profile:

databricks configure --profile myprofile
# then use: uc-mcp-proxy --url <url> --profile myprofile

How It Works

1. Starts a local MCP stdio server (Claude connects to this)
2. Opens an HTTP connection to the remote Databricks MCP server
3. Injects a fresh OAuth token on every outbound request
4. Bridges messages bidirectionally between the two transports

Troubleshooting

Tools not appearing in Claude Restart Claude Code/Desktop after editing .mcp.json. The proxy must be running — check with uvx uc-mcp-proxy --url <url> directly in terminal.

401 Unauthorized

• For Apps: make sure you're using --auth-type databricks-cli, not PAT
• For Managed/External: check your token is valid — databricks auth env
• Try --profile to specify a non-default profile

Connection refused / timeout

• Verify the URL is correct — check workspace URL and endpoint path
• For Apps: ensure the Databricks App is running (databricks bundle run)
• Check your workspace firewall/network policies

uvx: command not found Install uv via pip install uv or brew install uv. Alternatively, install uc-mcp-proxy directly: pip install uc-mcp-proxy (always verify the package source is pypi.org/project/uc-mcp-proxy).

Source: IceRhymers/uc-mcp-proxy — distributed by TomeVault.