MCP Databricks Server

Servidor MCP (Model Context Protocol) construído do zero para expor operações do Unity Catalog do Databricks — listagem de tabelas, descrição de schema e execução de queries somente-leitura — a qualquer cliente MCP (Claude Desktop, Claude Code).

O que é este projeto

Prova de conceito técnica com foco em profundidade de protocolo: o objetivo não é apenas "usar" o MCP SDK, mas demonstrar entendimento do ciclo de mensagens JSON-RPC 2.0 por trás dele (initialize → tools/list → tools/call), aplicado a um caso de uso real de Engenharia de Dados — trazer acesso a metadados de catálogo para dentro do fluxo de trabalho de IA, sem sair do editor/terminal.

Related MCP server: Databricks MCP Server

Status

🚧 Em desenvolvimento — fase de validação de ambiente.

Requisitos funcionais

Requisitos não funcionais

Arquitetura

Ver docs/architecture.md para o diagrama completo e o detalhamento do fluxo de mensagens do protocolo MCP.

Decisões técnicas (ADRs)

Stack

• Python 3.11+

• MCP Python SDK (oficial)

• databricks-sdk

• pytest

Setup local

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env  # preencher DATABRICKS_HOST e DATABRICKS_TOKEN

Como testar a conexão antes de rodar o server

Ver docs/testing-checklist.md — checklist de validação de ambiente (PAT, SDK, SQL Warehouse) que deve passar antes de qualquer lógica de tool ser implementada.

Como rodar

python src/server.py

Registrar no claude_desktop_config.json (ver claude_desktop_config.example.json neste repositório).

Licença

MIT