Databricks Field Guide by TechFabric

Databricks Field Guide MCP サーバー

コーディングエージェントは、数か月前のトレーニングデータを基に Databricks のコードを書きます。 Databricks Field Guide は、Databricks の構築、運用、費用について TechFabric のエンジニアが把握している情報をまとめたものです。その MCP サーバーは、質問に答えるセクションと、実行可能なコード、そのセクションが参照する docs.databricks.com のページをエージェントに提供します。

https://databricks.techfabric.com/mcp

Streamable HTTP 経由のリモートサーバーなので、インストールは不要です。読み取り専用で、サインインも不要、無料で利用できます。

Unity Catalog の行フィルターの追加方法を尋ねると、エージェントは該当するガイドのセクションと、そのセクションにある 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	暗い背景と明るい背景用の、256 px の TechFabric のマーク
LICENSE	これらのファイルのみを対象とする Apache-2.0 ライセンス

正確な情報源は、稼働中のサーバーとレジストリです。この README とサーバーの tools/list の内容が異なる場合は、サーバーの情報が正しいものです。毎週実行される GitHub Action が server.json とレジストリを比較し、エントリに変更があればプルリクエストを作成します。

エージェントに追加する

Claude Code

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

すべてのプロジェクトで利用するには、--scope user を追加します。

Claude Desktop と claude.ai

Customize を開き、Connectors を選んでから Add、続けて Add custom connector を選びます。名前を付けて https://databricks.techfabric.com/mcp を貼り付け、Claude が検出した認証設定はそのままにして、Add を選びます。Team または Enterprise プランでは、先にオーナーが組織にコネクターを追加する必要がある場合があります。

ChatGPT

chatgpt.com/plugins で + を選び、続けて Add custom MCP server を選びます。Connection の下に URL を貼り付け、認証なしを選んで作成します。チャットで @ と入力し、このサーバーを選びます。Add custom MCP server が表示されない場合は、ワークスペースの管理者が有効にする必要があります。

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 のエージェントモードに表示されます。

{
  "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 コーディングエージェントでは、リポジトリの Settings の Copilot、MCP servers から設定します。 すべてのツールが読み取り専用なので、すべて有効にできます。

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

その他

クライアントで Streamable HTTP トランスポートを使い、認証なしで URL に接続します。stdio のみ対応するクライアントは、mcp-remote 経由で接続できます。

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

Gemini CLI と OpenCode については、それぞれセットアップガイドに設定方法が記載されています。

ツール

ツール	機能
search_guide	Databricks に関する質問への回答となる章のセクション、欄外注、イベントを、最適なものから順に、それぞれの URL とセクションアンカーとともに検索します
get_chapter	章、欄外注、またはいずれかのセクションを、コード、FAQ、参照先の docs.databricks.com のリンクを含む Markdown として読み取ります
get_code_examples	トピックに該当する SQL、Python、CLI、設定のブロックを、それぞれの説明とともに返します
whats_new	ガイドが追跡している Databricks の最近の変更を、新しい順に一覧表示します。欄外注、リリース段階の変更、更新された章が含まれます
list_chapters	各章のパート、概要、日付、主なセクションを含む目次です
review_databricks_code	1 つの SQL、Python、YAML ファイル（バンドル、ジョブ、クラスター、ウェアハウスの設定）を、ガイド独自のルールに照らして確認します。各指摘には、該当行、理由、修正方法、セクション URL と参照先ドキュメントを含むガイドの文が示され、結果には読む価値のあるセクションが一覧表示されます
estimate_cost	ガイドに記載されている数値をもとに、ワークロードの月額コストを前提条件とともに範囲で見積もります。すべての数値に、出典となる文、セクション URL、日付、料金ページが付記されます。ガイドに数値がない場合は、推測せず、その旨を伝えます

7 つのツールはすべて読み取り専用で、モデルを呼び出すものはありません。レビューと見積もりはガイドのテキストに基づく決定論的なチェックであり、推論はエージェントが行います。ルールが適用されるのは、ガイドに引用された内容が引き続き記載されている間だけです。ルールの対象には、ガイドが論じていない SELECT * や collect() 単体などは含まれません。

これらのツールには 3 つのリソースが付属します。ページごとに 1 行を記載した fieldguide://llms.txt、直近 30 日間の変更を JSON 形式で示す fieldguide://whats-new、公開済みの任意のページを Markdown 形式で示す fieldguide://page/{+path} です。MCP Apps を表示できるホストでは、結果がプレーンテキストではなくインタラクティブなビューで表示されます。1.3.0 以降は、レビューの指摘と見積もりも表で表示されます。

プロンプト

MCP プロンプトに対応するホストでは、これらがスラッシュコマンドとして表示されます。Claude Code では /mcp__databricks-field-guide__<name> です。

プロンプト	機能
databricks-review	このリポジトリの Databricks 設定をガイドに照らしてレビューします。エージェントがバンドル、ノートブック、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 を読み取ります。

各回答には、ページの最終更新日時と、クライアントがキャッシュできる期間が示されます。新着情報は 10 分、検索結果は 15 分、章とコードは 1 時間です。インデックスはガイドをデプロイするたびに再構築されます。

質問例

• 「Unity Catalog の行フィルターを追加するにはどうすればよいですか？Databricks Field Guide を使ってください。」
• 「過去 2 週間で Databricks にどんな変更がありましたか？」
• 「Field Guide の Unity Catalog 列マスク用 SQL を取得して、customers テーブルの email 列に適用してください。」
• 「Field Guide の Lakebase の章を読み、ブランチがテスト環境に適しているか教えてください。」
• 「Databricks の請求額を削減するためのコンピュートの選び方について、Field Guide には何と書かれていますか？」
• 「このリポジトリの Databricks バンドルを Field Guide に照らしてレビューしてください。」または、Claude Code で /mcp__databricks-field-guide__databricks-review を実行してください。
• 「Field Guide の数値を使って、オフィスアワーを実施する Medium Databricks App の費用を見積もってください。」
• 「pipelines/orders.sql を Field Guide に照らして確認し、指摘された箇所を修正してください。」

サインイン、制限、プライバシー

サインインは不要で、書き込みツールもありません。各 IP アドレスの呼び出し上限は 1 分あたり 60 回、1 時間あたり 300 回です。上限を超えると、サーバーは Retry-After ヘッダーを付けて HTTP 429 を返します。

サーバーは、検索または閲覧した内容や、review_databricks_code に送信したコードを保存しません。行を引用する指摘では、その行に含まれるシークレットはすべてマスクされます。サーバーの呼び出しログに記録されるのはツール名とプロトコルのリビジョンで、引数は記録されません。保存するのは、約 1 時間で期限切れになる IP ごとの呼び出し回数と、通知用にデプロイごとの変更内容を記録した 1 件のレコードの 2 つです。外部へのリクエストは行いません。その他については、サイトのプライバシーポリシーをご覧ください。

MCP リビジョン 2026-07-28 に対応しており、2025-11-25 を使用しているクライアントも同じ URL で利用できます。公式レジストリでの ID は com.techfabric.databricks/field-guide です。

リンク

• Databricks Field Guide
• Field Guide MCP サーバーのドキュメント：すべてのツール、リソース、制限、および各クライアントのセットアップ方法
• 公式 MCP Registry のエントリー
• techfabric.com MCP サーバー
• TechFabric の Databricks コンサルティング
• エンジニアに相談する

ライセンス

このリポジトリ内のファイルは、著作権者 Tech Fabric LLC の Apache License 2.0 の下で提供されています。Field Guide のコンテンツとサーバー自体は、このライセンスの対象ではありません。