Databricks MCP Server

A Databricks MCP Server is a Model Context Protocol server that exposes Databricks platform capabilities (Unity Catalog, SQL, Jobs, Clusters, etc.) as MCP tools that AI agents can dynamically discover and call.

CN: Databricks MCP Server 是一个 MCP 服务器,它将 Databricks 平台的能力(Unity Catalog、SQL、Jobs、Clusters 等)暴露为 MCP 工具,让 AI Agent 可以动态发现和调用这些工具。

Databricks provides three types of MCP servers:

CN: Databricks 提供三种类型的 MCP 服务器:

Type / 类型EN DescriptionCN 说明
Managed MCPPre-configured, ready-to-use servers for Vector Search, Genie spaces, SQL, and Unity Catalog functions预配置、开箱即用的服务器,用于 Vector Search、Genie spaces、SQL 和 Unity Catalog functions
External MCPSecurely connect to MCP servers hosted outside Databricks using managed connections使用托管连接安全地连接到 Databricks 外部托管的 MCP 服务器
Custom MCPHost your own custom MCP server as a Databricks App将自己的自定义 MCP 服务器托管为 Databricks App

2.1 Managed MCP Servers(托管 MCP 服务器)

EN: Databricks provides the following managed MCP servers that work out of the box:

CN: Databricks 提供以下开箱即用的托管 MCP 服务器:

ServerEN PurposeCN 用途URL Pattern
Vector SearchQuery Vector Search indexes to find relevant documents查询 Vector Search 索引查找相关文档https://<workspace>/api/2.0/mcp/vector-search/{catalog}/{schema}/{index_name}
Genie SpaceQuery Genie spaces to analyze structured data using natural language查询 Genie spaces 用自然语言分析结构化数据https://<workspace>/api/2.0/mcp/genie/{genie_space_id}
Databricks SQLRun AI-generated SQL to author data pipelines运行 AI 生成的 SQL 来编写数据管道https://<workspace>/api/2.0/mcp/sql
Unity Catalog FunctionsUse Unity Catalog functions to run predefined SQL queries使用 Unity Catalog functions 运行预定义的 SQL 查询https://<workspace>/api/2.0/mcp/functions/{catalog}/{schema}/{function_name}

2.2 Custom MCP Servers(自定义 MCP 服务器)

EN: You can host custom or third-party MCP servers as Databricks Apps. This is useful if you:

  • Already have an MCP server you want to deploy
  • Want to run a third-party MCP server as a tool source
  • Need custom business logic not covered by managed servers

CN: 你可以将自定义或第三方的 MCP 服务器托管为 Databricks Apps。 这在以下情况很有用:

  • 你已经有一个想部署的 MCP 服务器
  • 想运行一个第三方 MCP 服务器作为工具来源
  • 需要托管服务器未覆盖的自定义业务逻辑

Key Takeaways

要点ENCN
Databricks MCP Server 类型Three types: Managed, External, Custom三种类型:托管、外部、自定义
认证由 SDK 自动处理Authentication is auto-handled by Databricks SDK认证由 Databricks SDK 自动处理
Claude Desktop 配置文件位置 (macOS)~/Library/Application Support/Claude/claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop 配置文件位置 (Windows)%APPDATA%\Claude\claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json
工具定义使用 @server.list_tools()Define tools with @server.list_tools()用 @server.list_tools() 定义工具
工具执行使用 @server.call_tool()Execute tools with @server.call_tool()用 @server.call_tool() 执行工具
Databricks SDK 核心客户端WorkspaceClient() for all Databricks operationsWorkspaceClient() 用于所有 Databricks 操作
不要硬编码工具名称Do not hardcode tool names — dynamically discover at runtime不要硬编码工具名称——运行时动态发现
让 LLM 决定调用哪个工具Let the LLM decide which tools to call让 LLM 决定调用哪个工具
使用 uvx 运行 MCP 服务器Use uvx to run MCP servers without global install使用 uvx 运行 MCP 服务器,无需全局安装