CockroachDB MCP

Databasestdio
Repository

A Model Context Protocol server that provides a natural-language interface for LLMs and agents to manage, monitor, and query data in CockroachDB. Supports schema exploration, query plan inspection, and running SQL, with a read-only-by-default posture so agents can investigate a distributed SQL cluster safely.

Connect

Add this configuration to .claude/mcp.json

{
  "mcpServers": {
    "cockroachdb": {
      "command": "npx",
      "args": [],
      "env": {
        "COCKROACHDB_URL": "<YOUR_COCKROACHDB_URL>"
      }
    }
  }
}

Tools (2)

run_query

Execute a SQL query against the connected CockroachDB cluster.

{
  "type": "object",
  "required": [
    "sql"
  ],
  "properties": {
    "sql": {
      "type": "string",
      "description": "SQL statement to execute"
    }
  }
}

describe_schema

Return the schema for a table or the whole database.

{
  "type": "object",
  "properties": {
    "table": {
      "type": "string",
      "description": "Optional table name to describe"
    }
  }
}

Resources

This server does not expose any resources.

Prompts

This server does not expose any prompts.

Server information

Author
Amine El Kouhen (@amineelkouhen)
Repository
https://github.com/amineelkouhen/mcp-cockroachdb
License
MIT
Stars
0
Last updated
July 25, 2026