Databricks MCP Server 8cbc3774

MCPAI代理

提供方 octavioccl

AI代理 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个为AI代理提供与Databricks工作区交互的全面工具集的FastMCP服务器,支持目录管理、查询执行、集群管理、作业管理、笔记本操作和DBFS文件系统操作。

一句话选型结论

按资料字段整理

Databricks MCP Server 8cbc3774 属于AI代理类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Databricks工具Python本地部署AI代理数据管理集群管理作业自动化

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
pip install fastmcp 'mcp[cli]' databricks-sdk

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Databricks MCP Server 8cbc3774当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方octavioccl上游标注的维护方 octavioccl
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.1 KB
来自项目仓库与上游目录的原文,未做删改

Databricks MCP Server

A comprehensive FastMCP server that provides AI agents with powerful tools to interact with Databricks workspaces. Built with modern MCP best practices using individual @mcp.tool() decorated functions in a single, efficient server.

🚀 Architecture

This project uses a unified FastMCP server architecture with all tools implemented as individual @mcp.tool() decorated functions, providing:

  • 35+ MCP Tools across 6 comprehensive categories
  • Single Entry Point: Simplified deployment and management
  • Async/Await Support: With event loop conflict handling for Docker environments
  • JSON Responses: Structured, consistent tool outputs
  • Thread-Safe: Concurrent tool execution support
  • Docker Ready: Optimized for containerized deployment with Poetry

✨ Features

🗄️ Catalog Management Tools (6 tools)

  • list_catalogs - Browse available data catalogs
  • list_schemas - Explore schemas within catalogs
  • list_tables - Discover tables and views
  • get_table_info - Get detailed table metadata and schema
  • search_tables - Find tables using pattern matching
  • generate_sql_query - AI-powered SQL generation from natural language

🔍 Advanced Query Execution (2 tools)

  • execute_query - Execute SQL queries with automatic LIMIT handling
  • execute_statement - Advanced SQL execution with parameters, catalogs, schemas, and timeout control

🖥️ Cluster Management (7 tools)

  • list_clusters - View all workspace clusters
  • get_cluster - Get detailed cluster information
  • create_cluster - Create new clusters with autoscaling
  • start_cluster - Start stopped clusters
  • terminate_cluster - Terminate running clusters
  • restart_cluster - Restart clusters for maintenance
  • resize_cluster - Dynamically resize cluster capacity

⚙️ Job Management (9 tools)

  • list_jobs - Browse all workspace jobs
  • get_job - Get detailed job configuration
  • run_job - Execute jobs with custom parameters
  • create_job - Create new job definitions
  • update_job - Modify existing jobs
  • delete_job - Remove job definitions
  • get_run - Get job run details and status
  • cancel_run - Cancel running job executions
  • list_runs - Browse job execution history

📓 Notebook Operations (7 tools)

  • list_notebooks - Browse workspace notebooks
  • get_notebook - Retrieve notebook metadata
  • export_notebook - Export in multiple formats (SOURCE, HTML, JUPYTER, DBC)
  • import_notebook - Import notebooks with base64 content
  • delete_notebook - Remove notebooks safely
  • create_directory - Create workspace directories
  • get_notebook_status - Check notebook availability

📁 DBFS File System (8 tools)

  • list_files - Browse DBFS directories
  • get_file - Download file contents (text/binary)
  • put_file - Upload files with base64 encoding
  • upload_large_file - Chunked upload for large files
  • delete_file - Remove files and directories
  • get_status - Get file/directory metadata
  • create_directory - Create DBFS directories
  • move_file - Move/rename files and directories

🛠️ Installation & Setup

Prerequisites

  • Python 3.8+
  • Databricks workspace access
  • Personal Access Token or Service Principal credentials

Quick Start

  1. Install dependencies:bash pip install fastmcp 'mcp[cli]' databricks-sdk

  2. Set environment variables:bash export DATABRICKS_HOST=https://your-workspace.cloud.databricks.com export DATABRICKS_TOKEN=your-personal-access-token export DATABRICKS_SQL_WAREHOUSE_ID=your-warehouse-id # optional

  3. Run the server:```bash
    # Using the CLI script
    ./bin/databricks-mcp-server

# Or directly with Python
python src/databricks_mcp/servers/main.py
```

Claude Desktop Configuration

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: `%APPDATA%/Claude/claude_desktop_config.json````json
{
"mcpServers": {
"databricks": {
"command": "python",
"args": ["/path/to/databricks-mcp-server/src/databricks_mcp/servers/main.py"],
"env": {
"DATABRICKS_HOST": "https://your-workspace.cloud.databricks.com",
"DATABRICKS_TOKEN": "your-token-here"
}
}
}
}


## 🐳 Docker Deployment

### Using Docker Compose

1. **Copy environment configuration:**```bash
   cp config.env.example config.env
   # Edit config.env with your Databricks credentials
   ```

2. **Build and run:**```bash
   docker-compose -f deploy/docker/docker-compose.yml up --build
   ```

### Claude Desktop with Docker```json
{
  "mcpServers": {
    "databricks": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "--env-file", "/path/to/config.env",
        "databricks-mcp-server"
      ]
    }
  }
}

🔧 Configuration

Environment Variables

Required:```bash
DATABRICKS_HOST=https://your-workspace.cloud.databricks.com
DATABRICKS_TOKEN=your-personal-access-token


**Optional:**```bash
DATABRICKS_SQL_WAREHOUSE_ID=your-sql-warehouse-id
DATABRICKS_DEFAULT_CATALOG=main
DATABRICKS_DEFAULT_SCHEMA=default
MCP_SERVER_NAME=databricks-mcp
MCP_LOG_LEVEL=INFO
MCP_ENABLE_QUERY_EXECUTION=true
MCP_ENABLE_NATURAL_LANGUAGE=true

Security Considerations

  • Store tokens securely (environment variables, not in code)
  • Use SQL Warehouse IDs for query execution (recommended)
  • Consider read-only access tokens for production use
  • Validate all SQL queries through built-in query validator

🧪 Testing & Development

Test Connection```bash

./bin/databricks-mcp-server --test


### Development Mode```bash
# Start with debug logging
./bin/databricks-mcp-server --log DEBUG

# Test with MCP Inspector
npx @modelcontextprotocol/inspector python src/databricks_mcp/servers/main.py

Adding New Tools

  1. Add your tool function to src/databricks_mcp/core/server_fastmcp.py
  2. Use the @mcp.tool() decorator
  3. Follow the established error handling pattern
  4. Test with the MCP Inspector

Example:```python
@mcp.tool()
async def my_new_tool(param: str) -> str:
"""Description of what this tool does."""
try:
client = get_databricks_client()

    # Try async first, fall back to sync in thread if needed
    try:
        result = await client.some_operation(param)
    except RuntimeError as e:
        if "cannot be called from a running event loop" in str(e):
            logger.warning("Event loop conflict detected, running in separate thread")
            result = run_sync_in_thread(client.some_operation(param))
        else:
            raise

    return json.dumps(result, indent=2)
except Exception as e:
    return json.dumps({
        "status": "error",
        "error": str(e)
    }, indent=2)

## 📊 Performance

- **Memory Usage**: ~50-100MB per server instance
- **Startup Time**: ~2-5 seconds (depending on Databricks connection)
- **Tool Execution**: ~100-2000ms per tool (depending on operation)
- **Concurrent Requests**: Thread-safe, supports multiple concurrent tool calls
- **Docker Overhead**: Minimal, single process architecture

## 🔍 Troubleshooting

### Common Issues

1. **AsyncIO Event Loop Conflicts**: The server automatically handles these by running operations in separate threads
2. **Connection Timeouts**: Check your `DATABRICKS_HOST` and `DATABRICKS_TOKEN`
3. **Permission Errors**: Ensure your token has appropriate workspace permissions
4. **Docker Issues**: Verify environment variables are properly passed to the container

### Debug Mode```bash
./bin/databricks-mcp-server --log DEBUG --test

Logs

The server provides comprehensive logging. Check logs for:
- Connection status
- Tool execution details
- Error messages with suggested fixes
- Performance metrics

📚 Documentation

  • Project Structure - Detailed architecture overview
  • AsyncIO Guide - Handling async event loops
  • Docker Guide - Container deployment
  • Examples - Usage examples and demos

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes following the established patterns
  4. Test your changes (python -m py_compile src/databricks_mcp/core/server_fastmcp.py)
  5. Commit your changes (git commit -m 'Add amazing feature')
  6. Push to the branch (git push origin feature/amazing-feature)
  7. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • FastMCP - Modern MCP server framework
  • Databricks SDK - Python SDK for Databricks
  • Model Context Protocol - Protocol specification
  • Anthropic - MCP protocol development

Built with ❤️ using FastMCP and the Databricks SDK

This server provides a comprehensive interface between AI agents and Databricks workspaces, enabling powerful data analysis, job management, and workspace automation through natural language interactions.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Databricks MCP Server 8cbc3774 怎么安装?

在客户端按下面的安装命令接入:pip install fastmcp 'mcp[cli]' databricks-sdk。装完在客户端配置里引用同一个包或端点。

Databricks MCP Server 8cbc3774 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Databricks MCP Server 8cbc3774 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Databricks MCP Server 8cbc3774 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Databricks MCP Server 8cbc3774 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Databricks MCP Server 8cbc3774 能提供哪些能力?

资料显示能力标签包括 集群管理、Python、Claude、数据管理。具体工具清单以官方文档为准。

Databricks MCP Server 8cbc3774 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Databricks MCP Server 8cbc3774 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。