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 Description CN 说明 Managed MCP Pre-configured, ready-to-use servers for Vector Search, Genie spaces, SQL, and Unity Catalog functions 预配置、开箱即用的服务器,用于 Vector Search、Genie spaces、SQL 和 Unity Catalog functions External MCP Securely connect to MCP servers hosted outside Databricks using managed connections 使用托管连接安全地连接到 Databricks 外部托管的 MCP 服务器 Custom MCP Host 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 服务器:
Server EN Purpose CN 用途 URL Pattern Vector Search Query Vector Search indexes to find relevant documents 查询 Vector Search 索引查找相关文档 https://<workspace>/api/2.0/mcp/vector-search/{catalog}/{schema}/{index_name}Genie Space Query Genie spaces to analyze structured data using natural language 查询 Genie spaces 用自然语言分析结构化数据 https://<workspace>/api/2.0/mcp/genie/{genie_space_id}Databricks SQL Run AI-generated SQL to author data pipelines 运行 AI 生成的 SQL 来编写数据管道 https://<workspace>/api/2.0/mcp/sqlUnity Catalog Functions Use 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
要点 EN CN 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.jsonClaude 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 服务器,无需全局安装