Databricks Permissions MCP Server

🚀 Databricks Permissions MCP Server

A server implementing the MCP protocol, providing secure access to Databricks permissions, credentials, and Git credentials. This enables LLM-powered tools like Claude to interact with the Databricks permissions management system.

🚀 Quick Start

The Databricks Permissions MCP Server is a powerful tool that allows LLM-driven applications to interact with Databricks' permission management system. It provides secure access to Databricks permissions, credentials, and Git credentials through the implementation of the MCP protocol.

✨ Features

• MCP Protocol Support: Implements the MCP protocol to allow LLMs to manage Databricks permissions.
• Databricks API Integration: Provides secure access to the Databricks permissions REST API.
• Permissions Management: A comprehensive tool for managing permissions on various Databricks resources.
• Git Credential Management: Tools for creating, listing, updating, and deleting Git credentials.
• Asynchronous Support: Implements efficient operation using asyncio.

💻 Usage Examples

Available Tools

The Databricks Permissions MCP Server exposes the following tools:

Permissions Management

• get_permissions: Get permissions for a Databricks object.
• set_permissions: Set permissions for a Databricks object.
• update_permissions: Update permissions for a Databricks object.
• get_permission_levels: Get available permission levels for a Databricks object type.

Resource-Specific Permissions

• get_cluster_permissions: Get permissions for a cluster.
• set_cluster_permissions: Set permissions for a cluster.
• update_cluster_permissions: Update permissions for a cluster.
• get_job_permissions: Get permissions for a job.
• set_job_permissions: Set permissions for a job.
• get_warehouse_permissions: Get permissions for a SQL warehouse.
• get_workspace_object_permissions: Get permissions for workspace objects (notebooks, directories).

Service Principals

• list_service_principals: List all service principals in the workspace.
• get_service_principal: Get details for a specific service principal.
• create_service_principal: Create a new service principal.
• update_service_principal: Update an existing service principal.
• delete_service_principal: Delete a service principal.

Unity Catalog Permissions

• get_catalog_permissions: Get permissions for a Unity Catalog warehouse.
• get_schema_permissions: Get permissions for a Unity Catalog schema.
• get_table_permissions: Get permissions for a Unity Catalog table.

Git Credential Management

• list_git_credentials: List all Git credentials.
• create_git_credential: Create a new Git credential.
• update_git_credential: Update an existing Git credential.
• delete_git_credential: Delete a Git credential.

📦 Installation

Prerequisites

• Python 3.10 or higher
• MCP protocol-compatible tools

Installation Steps

# Install the project using pip
pip install databricks-permissions-mcp-server

🔧 Technical Details

Code Standards

• Follow the PEP 8 code style guide with a maximum line length of 100 characters.
• All classes, methods, and functions must have Google-style docstrings.
• All code (except tests) must use type hints.

🧪 Testing

The project uses pytest for testing. To run the tests:

# Run all tests
pytest tests/

# Generate a coverage report
pytest --cov=src tests/ --cov-report=term-missing

📄 License

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