Databricks SQL工具服务器

Databricks MCP服务器通过模型上下文协议暴露Databricks SQL工具,使用OAuth服务主体进行认证,无需个人访问令牌。

  • by journeymannbuilds
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 journeymannbuilds/mcp

使用说明

_CHMCP服务器

一个最小的MCP服务器,它通过模型上下文协议公开ConnectionSQL工具。使用OAuth服务主体(M2M)进行身份验证——不需要PAT。

工具

工具 说明
list_tables 列出给定目录中的所有表
describe_table 描述完全限定表的列
query 执行只读SQL查询

设置

  1. 克隆和安装依赖关系:
pip install -r requirements.txt
  1. 配置环境变量:
cp .env.example .env
# Fill in your Databricks workspace details and service principal credentials

所需变量:

  • DATABRICKS_HOST --copula工作区URL
  • DATABRICKS_HTTP_PATH --SQL仓库HTTP路径
  • DATABRICKS_CLIENT_ID --服务主体客户端ID
  • DATABRICKS_CLIENT_SECRET --服务主体-客户端机密
  1. 运行服务器:
python server.py

默认情况下,服务器使用stdio传输进行MCP通信。

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "databricks": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}

约束条件

  • 只读 --写操作(INSERT、UPDATE、DELETE、DROP等)被阻止。
  • 分区修剪 --对Skyscanner表的查询必须包括 dt 柱过滤器。