Databricks Field Guide by TechFabric

Databricks Field Guide MCP 服务

编码 Agent 编写 Databricks 代码时，所依据的训练数据可能已经过时数月。 Databricks Field Guide 汇集了 TechFabric 工程师在构建、运行和为 Databricks 付费方面的经验，其 MCP 服务会为你的 Agent 提供能解答问题的指南章节、可运行的代码，以及该章节引用的 docs.databricks.com 页面。

https://databricks.techfabric.com/mcp

这是一个基于 Streamable HTTP 的远程服务，无需安装。它是只读的，无需登录，而且免费。

询问如何添加 Unity Catalog 行过滤器，Agent 就会获取指南中相关的章节、该章节提供的 SQL 函数，以及背后的 Databricks 文档。Databricks 官方文档仍然是语法和限制方面的权威来源，因此每个回答都会附上相关链接。

这不是 Databricks 自己的 MCP 服务。Databricks 在工作区内运行可操作你数据的托管 MCP 服务。这个服务由 Databricks 合作伙伴 TechFabric 构建和运行，且从不连接到工作区。

此仓库包含什么

描述文件，让 MCP 目录有一个可列出的仓库。官方 MCP Registry 条目列出了此仓库，GitHub 的 MCP Registry 会在 Copilot 中显示此 README。服务代码不在此处，也不是开源的。

文件	内容
server.json	此服务在官方 MCP Registry中的条目，按发布内容复制
glama.json	Glama 的维护者列表
icon.png、icon-light.png	TechFabric 标志，尺寸为 256 px，适用于深色和浅色背景
LICENSE	Apache-2.0 许可证，仅适用于这些文件

实时服务和注册表是权威来源。如果此 README 与服务的 tools/list 有任何不一致，以服务为准。每周运行的 GitHub Action 会将 server.json 与注册表进行比较，并在条目发生变化时创建拉取请求。

将其添加到你的 Agent

Claude Code

claude mcp add --transport http databricks-field-guide https://databricks.techfabric.com/mcp

添加 --scope user，即可在每个项目中使用。

Claude Desktop 和 claude.ai

打开 自定义，然后选择 连接器，点击 添加，再选择 添加自定义连接器。为其命名，粘贴 https://databricks.techfabric.com/mcp，保留 Claude 检测到的身份验证设置，然后点击 添加。如果使用 Team 或 Enterprise 计划，可能需要所有者先为组织添加连接器。

ChatGPT

前往 chatgpt.com/plugins，选择 +，然后选择 添加自定义 MCP 服务。在 连接 下粘贴 URL，选择不使用身份验证，然后创建服务。在聊天中输入 @ 并选择它。如果没有 添加自定义 MCP 服务 选项，则需要由工作区管理员启用该功能。

Codex

codex mcp add databricks-field-guide --url https://databricks.techfabric.com/mcp

或者，手动编辑 ~/.codex/config.toml：

[mcp_servers.databricks-field-guide]
url = "https://databricks.techfabric.com/mcp"

Cursor

每个项目使用 ~/.cursor/mcp.json，或单个项目使用 .cursor/mcp.json：

{
  "mcpServers": {
    "databricks-field-guide": { "url": "https://databricks.techfabric.com/mcp" }
  }
}

VS Code

在 .vscode/mcp.json 中配置，然后从该文件或 MCP 视图启动。工具会显示在 Copilot 的 Agent 模式中。

{
  "servers": {
    "databricks-field-guide": { "type": "http", "url": "https://databricks.techfabric.com/mcp" }
  }
}

GitHub Copilot

在 VS Code 中使用上述配置。Copilot CLI 会将服务保存到 ~/.copilot/mcp-config.json，供每个项目使用：

copilot mcp add --transport http databricks-field-guide https://databricks.techfabric.com/mcp

github.com 上的 Copilot 编码 Agent 可在仓库的 Settings 中，通过 Copilot 下的 MCP servers 添加该服务。 所有工具均为只读，因此可以全部启用：

{
  "mcpServers": {
    "databricks-field-guide": {
      "type": "http",
      "url": "https://databricks.techfabric.com/mcp",
      "tools": ["*"]
    }
  }
}

其他客户端

将客户端指向该 URL，并使用 Streamable HTTP 传输方式且不进行身份验证。仅支持 stdio 的客户端可以通过 mcp-remote 连接：

npx mcp-remote https://databricks.techfabric.com/mcp

Gemini CLI 和 OpenCode 各自在设置指南中有单独的说明。

工具

工具	功能说明
search_guide	查找最适合回答 Databricks 问题的章节部分、边注和活动，并提供各自的 URL 和章节锚点
get_chapter	以 Markdown 形式读取一章、一条边注或其中一个部分，包括代码、常见问题解答以及所引用的 docs.databricks.com 链接
get_code_examples	返回与主题匹配的 SQL、Python、CLI 和配置代码块，并附上每个代码块周围的说明
whats_new	按时间从新到旧列出指南跟踪的 Databricks 最新变更：边注、发布阶段变更和更新的章节
list_chapters	目录，包含每章所属部分、摘要、日期和主要章节
review_databricks_code	根据指南自身的规则检查一个 SQL、Python 或 YAML 文件（bundle、job、cluster 或 warehouse 配置）。每条发现都包含行号、原因、修复方法、指南中对应的句子及其章节 URL 和所引用的文档；结果还会列出值得阅读的章节
estimate_cost	根据指南列出的数据估算工作负载的月度成本，并以范围形式给出，同时说明假设。每个数字都附有来源句子、章节 URL、日期和定价页面；如果指南没有提供数据，也会明确说明，而不会猜测

这七个工具均为只读，且都不会调用模型：审查和估算是根据指南文本进行的确定性检查，由你的 Agent 负责推理。只有在指南仍然写明所引用的内容时，规则才适用。这些规则不会涵盖指南未提出的内容，例如单独使用 SELECT * 或 collect()。

它们还附带三个资源：fieldguide://llms.txt，每页一行；fieldguide://whats-new，以 JSON 格式提供最近 30 天的变更；以及 fieldguide://page/{+path}，以 Markdown 格式提供任意已发布页面。能够呈现 MCP Apps 的主机，会以交互视图而非纯文本展示结果：从 1.3.0 开始，这也包括审查结果和表格形式的估算。

提示词

支持 MCP 提示词的主机会将其显示为斜杠命令。在 Claude Code 中，它们的格式为 /mcp__databricks-field-guide__<name>。

提示词	功能说明
databricks-review	根据指南审查此代码库的 Databricks 设置。你的 Agent 会收集 bundles、notebooks、SQL 和计算配置，对每项运行 review_databricks_code，并附上链接总结发现
databricks-cost	使用 estimate_cost 估算此代码库中工作负载的成本，并清楚列出每个数据的来源、日期和缺失项
whats-new	总结 Databricks 最近的变更，以及其中哪些与此代码库相关
field-guide-chapter	将一章或其中一个部分以 Markdown 形式加入对话
field-guide-code	查找指南中与某个主题相关的代码示例，也可以限定在某一章中

输入章节和部分名称时会自动补全，页面资源的路径也一样。MCP 会补全提示词参数，而不是工具参数，因此应通过这些提示词补全 get_chapter 的章节名称。

通知

在 MCP 2026-07-28 中，客户端可以通过 subscriptions/listen 订阅 fieldguide://whats-new 或任意 fieldguide://page/...。当指南部署更新了已订阅的资源（例如新增边注、重写章节或某项功能变更发布阶段）时，服务端会发送 notifications/resources/updated。使用 2025-11-25 的客户端没有可用于推送通知的流，因此它们会改为读取 whats_new。

每个回答都会说明其页面上次变更的时间，以及客户端可以缓存多久：What's New 为 10 分钟，搜索为 15 分钟，章节和代码为 1 小时。每次部署指南时都会重建索引。

可以询问的问题

• “如何添加 Unity Catalog 行筛选器？使用 Databricks Field Guide。”
• “过去两周 Databricks 有哪些变化？”
• “获取 Field Guide 中 Unity Catalog 列掩码的 SQL，并将其应用到我的 customers 表中的 email 列。”
• “阅读 Field Guide 的 Lakebase 章节，告诉我分支是否适合我们的测试环境。”
• “Field Guide 对如何选择计算资源以降低 Databricks 账单有什么建议？”
• “根据 Field Guide 检查此代码库的 Databricks bundle。”或者在 Claude Code 中运行 /mcp__databricks-field-guide__databricks-review。
• “根据 Field Guide 中的数据，估算运行办公时间的 Medium Databricks App 的费用。”
• “根据 Field Guide 检查 pipelines/orders.sql，并修复标出的问题。”

登录、限制与隐私

无需登录，也没有写入工具。每个 IP 地址每分钟可调用 60 次，每小时可调用 300 次；超过限制后，服务端会返回带有 Retry-After 标头的 HTTP 429 响应。

服务端不会保存你搜索或阅读的内容，也不会保存你发送给 review_databricks_code 的代码。引用代码行的问题会屏蔽其中的任何机密信息。服务端的调用日志只记录工具名称和协议修订版本， 绝不记录参数。它会存储两类内容：每个 IP 地址的调用次数（约一小时后过期），以及每次部署的一条变更记录，用于发送 通知。它不会发起任何出站请求。其余事项请参阅网站的 隐私政策。

它支持 MCP 修订版本 2026-07-28；仍使用 2025-11-25 的客户端也可通过同一 URL 访问。它在官方注册表中的标识为 com.techfabric.databricks/field-guide。

链接

• Databricks Field Guide
• Field Guide MCP 服务文档：介绍每个工具、资源和限制，以及各客户端的设置方法
• 官方 MCP 注册表条目
• techfabric.com MCP 服务
• TechFabric 的 Databricks 咨询服务
• 联系工程师

许可证

此代码库中的文件采用 Apache License 2.0， 版权归 Tech Fabric LLC 所有。Field Guide 的内容和服务本身不受该许可证约束。