Для чего этот сервер?

Сервер даёт AI-агентам и LLM прямой доступ к CockroachDB через обычный язык. Вместо того чтобы писать SQL вручную, модель сама выполняет запросы, управляет схемами, следит за кластером и запускает административные команды. Это упрощает работу с базами данных — разработчики делегируют рутину, а агенты быстрее находят и меняют данные.

Каталог MCP
amineelkouhen/mcp-cockroachdb

amineelkouhen/mcp-cockroachdb

от amineelkouhen

MCP сервер для CockroachDB дает AI-агентам управлять базой через естественный язык: мониторинг кластера, выполнение запросов и администрирование. Строгая проверка прав и read-only режим для безопасности.

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

CockroachDB MCP Server

Overview

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.

Overview
Features
Tools
Installation
Configuration
- Configuration via command line arguments
- Configuration via Environment Variables
Integrations
Testing
Contributing
License
Quality Badge
Contact

Features

Natural-Language Queries: AI agents can query and transact via natural language.
Cluster Monitoring: Cluster status, node health, replication, slow queries, contention, index recommendations.
Database Operations: List, create, drop, and switch databases.
Table Management: Create, drop, alter (add/drop/rename column), truncate, rename, describe; bulk-import; indexes, views, schemas.
Query Engine: Parameterized SQL with json/csv/table output, multi-statement transactions, explain, history.
User & Privilege Management: Provision SQL users and roles, grant/revoke privileges. Lets you run the agent under a scoped non-root user.
Vector Search: Similarity search with cosine/L2/inner-product metrics (auto-detected from index opclass), C-SPANN ANN index management (v25.2+).
Job Management: Observe and control async jobs (BACKUP, RESTORE, IMPORT, CHANGEFEED, SCHEMA CHANGE).
Backup & Restore: Full / database / table backup and restore against s3, gs, azure, nodelocal, userfile.
Statistics: Create and show optimizer statistics.
Multi-Region: Regions, survival goals, locality (REGIONAL_BY_ROW etc.), zone configuration.
Changefeeds: CDC pipelines to Kafka / webhook / cloud-storage with sink-scheme validation.
Cluster Admin: Cluster settings, decommission/drain (gated).
Diagnostics: Tracing spans, statement-diagnostics bundles.
Safety First: Strict identifier validation, parameterized values, --read-only mode, explicit confirm=True for destructive ops, redacted DSN responses.
Seamless MCP Integration: Works with any MCP client (Claude Desktop, Cursor, VS Code Copilot, OpenAI Agents SDK, etc.).
Multiple Transports: stdio (default) and streamable HTTP.

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить amineelkouhen/mcp-cockroachdb:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "amineelkouhen-mcp-cockroachdb-ayerdn34nj": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/amineelkouhen/mcp-cockroachdb.git",
        "cockroachdb-mcp-server",
        "--url",
        "postgresql://root@localhost:26257/defaultdb",
        "--read-only"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "amineelkouhen-mcp-cockroachdb-ayerdn34nj": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/amineelkouhen/mcp-cockroachdb.git",
        "cockroachdb-mcp-server",
        "--url",
        "postgresql://root@localhost:26257/defaultdb",
        "--read-only"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "amineelkouhen-mcp-cockroachdb-ayerdn34nj": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/amineelkouhen/mcp-cockroachdb.git",
        "cockroachdb-mcp-server",
        "--url",
        "postgresql://root@localhost:26257/defaultdb",
        "--read-only"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"amineelkouhen-mcp-cockroachdb-ayerdn34nj\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"--from\",\"git+https://github.com/amineelkouhen/mcp-cockroachdb.git\",\"cockroachdb-mcp-server\",\"--url\",\"postgresql://root@localhost:26257/defaultdb\",\"--read-only\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "amineelkouhen-mcp-cockroachdb-ayerdn34nj": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/amineelkouhen/mcp-cockroachdb.git",
        "cockroachdb-mcp-server",
        "--url",
        "postgresql://root@localhost:26257/defaultdb",
        "--read-only"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add amineelkouhen-mcp-cockroachdb-ayerdn34nj -- uvx --from git+https://github.com/amineelkouhen/mcp-cockroachdb.git cockroachdb-mcp-server --url postgresql://root@localhost:26257/defaultdb --read-only

Либо через JSON-конфиг:

claude mcp add-json amineelkouhen-mcp-cockroachdb-ayerdn34nj "{\"command\":\"uvx\",\"args\":[\"--from\",\"git+https://github.com/amineelkouhen/mcp-cockroachdb.git\",\"cockroachdb-mcp-server\",\"--url\",\"postgresql://root@localhost:26257/defaultdb\",\"--read-only\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add amineelkouhen-mcp-cockroachdb-ayerdn34nj -- uvx --from git+https://github.com/amineelkouhen/mcp-cockroachdb.git cockroachdb-mcp-server --url postgresql://root@localhost:26257/defaultdb --read-only

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.amineelkouhen-mcp-cockroachdb-ayerdn34nj]
command = "uvx"
args = ["--from", "git+https://github.com/amineelkouhen/mcp-cockroachdb.git", "cockroachdb-mcp-server", "--url", "postgresql://root@localhost:26257/defaultdb", "--read-only"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите amineelkouhen/mcp-cockroachdb, а в поле команды запуска — строку ниже:

uvx --from git+https://github.com/amineelkouhen/mcp-cockroachdb.git cockroachdb-mcp-server --url postgresql://root@localhost:26257/defaultdb --read-only

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "amineelkouhen-mcp-cockroachdb-ayerdn34nj": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/amineelkouhen/mcp-cockroachdb.git",
        "cockroachdb-mcp-server",
        "--url",
        "postgresql://root@localhost:26257/defaultdb",
        "--read-only"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "amineelkouhen-mcp-cockroachdb-ayerdn34nj": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/amineelkouhen/mcp-cockroachdb.git",
        "cockroachdb-mcp-server",
        "--url",
        "postgresql://root@localhost:26257/defaultdb",
        "--read-only"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например amineelkouhen-mcp-cockroachdb-ayerdn34nj.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: amineelkouhen-mcp-cockroachdb-ayerdn34nj
    command: uvx
    args:
      - "--from"
      - "git+https://github.com/amineelkouhen/mcp-cockroachdb.git"
      - "cockroachdb-mcp-server"
      - "--url"
      - "postgresql://root@localhost:26257/defaultdb"
      - "--read-only"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "amineelkouhen-mcp-cockroachdb-ayerdn34nj": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/amineelkouhen/mcp-cockroachdb.git",
        "cockroachdb-mcp-server",
        "--url",
        "postgresql://root@localhost:26257/defaultdb",
        "--read-only"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/amineelkouhen/mcp-cockroachdb.git",
    "cockroachdb-mcp-server",
    "--url",
    "postgresql://root@localhost:26257/defaultdb",
    "--read-only"
  ]
}