Skip to content

Conversation

@amineelkouhen
Copy link

@amineelkouhen amineelkouhen commented Jul 14, 2025

Overview

This PR adds the CockroachDB MCP Server to the list of servers. This MCP server enables AI agents to manage, monitor, and query CockroachDB using natural language. Developers and users can perform complex database operations, cluster management, and query execution seamlessly through AI-driven workflows. This server integrates with MCP clients for scalable and high-performance data operations.

The CockroachDB MCP Server is a natural language interface designed for LLMs and agentic applications to manage, monitor, and query data in CockroachDB. It integrates seamlessly with MCP (Model Content Protocol) clients, such as Claude Desktop or Cursor, enabling AI-driven workflows to interact directly with your database.

Key Features

  • Natural Language Queries: Enables AI agents to query and create transactions using natural language, supporting complex workflows.
  • Search & Filtering: Supports efficient data retrieval and searching in CockroachDB.
  • Cluster Management: Check and monitor the CockroachDB cluster status, including node health and replication.
  • Database Management: Perform all operations related to databases, such as creation, deletion, and configuration.
  • Table Management: Handle tables, indexes, and schemas for flexible data modeling.
  • Seamless MCP Integration: Works with any MCP client for smooth communication.
  • Scalable & Lightweight: Designed for high-performance data operations.

Tools

This MCP Server provides tools to manage the data stored in CockroachDB.

Cluster Management

Purpose: Offers tools for monitoring and managing the CockroachDB cluster.
Summary:

  • Get cluster health and node status.
  • Show currently running queries.
  • Analyze query performance statistics.
  • Retrieve replication and distribution status for tables or the whole database.

Database Management

Purpose: Handles database-level operations and connection management.
Summary:

  • Connect to a CockroachDB database.
  • List, create, drop, and switch databases.
  • Get connection status and active sessions.
  • Retrieve database settings.

Table Management

Purpose: Provides tools for managing tables, indexes, views, and schema relationships in CockroachDB.
Summary:

  • Create, drop, and describe tables and views.
  • Bulk import data into tables.
  • Manage indexes (create/drop).
  • List tables, views, and table relationships.
  • Analyze schema structure and metadata.

Query Engine

Purpose: Executes and manages SQL queries and transactions.
Summary:

  • Execute SQL queries with formatting options (JSON, CSV, table).
  • Run multi-statement transactions.
  • Explain query plans for optimization.
  • Track and retrieve query history.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Protocol Documentation
  • My changes follow MCP security best practices
  • I have updated the server's README accordingly
  • I have tested this with an LLM client
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have documented all environment variables and configuration options

Further Details

  • License: MIT
  • Compatibility: Tested with Claude 4 Sonnet, GPT-4o.
  • Environment variables: CRDB_HOST (required), CRDB_PORT, CRDB_DATABASE, CRDB_USERNAME, CRDB_PWD, CRDB_SSL_MODE,CRDB_SSL_CA_PATH, CRDB_SSL_KEYFILE, CRDB_SSL_CERTFILE.

@amineelkouhen amineelkouhen changed the title My feature Adding CockroachDB MCP Server to the list of community servers Jul 14, 2025
@amineelkouhen amineelkouhen changed the title Adding CockroachDB MCP Server to the list of community servers Add CockroachDB MCP Server to the list of community servers Jul 14, 2025
@olaservo
Copy link
Member

Thanks for your contribution to the servers list. This has been merged in this combined PR: #2370

This is a new process we're trying out, so if you see any issues feel free to re-open the PR and tag me.

@olaservo olaservo closed this Jul 18, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants