Каталог MCP
gigamori/mcp-run-sql-connectorx

gigamori/mcp-run-sql-connectorx

Name: gigamori/mcp-run-sql-connectorx
Availability: InStock
Author: gigamori

MCP сервер выполняет SQL через ConnectorX и выводит результат в CSV или Parquet. Данные передаются через файлы, а не в теле сообщения, что эффективно для больших запросов. Поддерживает PostgreSQL, MySQL, SQLite и другие.

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

README

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

Версии

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

run-sql-connectorx

An MCP server that executes SQL via ConnectorX and streams the result to CSV or Parquet in PyArrow RecordBatch chunks.

Output formats: csv or parquet
CSV: UTF-8, header row is always written
Parquet: PyArrow defaults; schema mismatch across batches raises an error
Return value: the string "OK" on success, or "Error: <message>" on failure
On failure the partially written output file is deleted
CSV token counting (optional): per-line token counting via tiktoken (o200k_base) with a warning threshold

Why this library?

Efficient streaming: handles large results in Arrow RecordBatch chunks
Token-efficient for MCP: exchanges data via files instead of inline payloads
Cross-database via ConnectorX: one tool works across many backends
Robust I/O: CSV header handling, Parquet schema validation, safe cleanup on errors

Supported data sources (ConnectorX)

ConnectorX supports many databases. Common examples include:

PostgreSQL
MySQL / MariaDB
SQLite
Microsoft SQL Server
Amazon Redshift
Google BigQuery

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

Выберите клиент, чтобы установить gigamori/mcp-run-sql-connectorx:

Любой клиент

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

{
  "mcpServers": {
    "gigamori-mcp-run-sql-connectorx-4dy2macabf": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gigamori/mcp-run-sql-connectorx",
        "run-sql-connectorx",
        "--conn",
        "<connection_token>"
      ]
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "gigamori-mcp-run-sql-connectorx-4dy2macabf": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gigamori/mcp-run-sql-connectorx",
        "run-sql-connectorx",
        "--conn",
        "<connection_token>"
      ]
    }
  }
}

VS Code

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

{
  "servers": {
    "gigamori-mcp-run-sql-connectorx-4dy2macabf": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gigamori/mcp-run-sql-connectorx",
        "run-sql-connectorx",
        "--conn",
        "<connection_token>"
      ]
    }
  }
}

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

code --add-mcp "{\"name\":\"gigamori-mcp-run-sql-connectorx-4dy2macabf\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"--from\",\"git+https://github.com/gigamori/mcp-run-sql-connectorx\",\"run-sql-connectorx\",\"--conn\",\"<connection_token>\"]}"

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": {
    "gigamori-mcp-run-sql-connectorx-4dy2macabf": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gigamori/mcp-run-sql-connectorx",
        "run-sql-connectorx",
        "--conn",
        "<connection_token>"
      ]
    }
  }
}

Claude Code

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

claude mcp add gigamori-mcp-run-sql-connectorx-4dy2macabf -- uvx --from git+https://github.com/gigamori/mcp-run-sql-connectorx run-sql-connectorx --conn <connection_token>

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

claude mcp add-json gigamori-mcp-run-sql-connectorx-4dy2macabf "{\"command\":\"uvx\",\"args\":[\"--from\",\"git+https://github.com/gigamori/mcp-run-sql-connectorx\",\"run-sql-connectorx\",\"--conn\",\"<connection_token>\"]}"

Codex

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

codex mcp add gigamori-mcp-run-sql-connectorx-4dy2macabf -- uvx --from git+https://github.com/gigamori/mcp-run-sql-connectorx run-sql-connectorx --conn <connection_token>

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

[mcp_servers.gigamori-mcp-run-sql-connectorx-4dy2macabf]
command = "uvx"
args = ["--from", "git+https://github.com/gigamori/mcp-run-sql-connectorx", "run-sql-connectorx", "--conn", "<connection_token>"]

Perplexity

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

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

uvx --from git+https://github.com/gigamori/mcp-run-sql-connectorx run-sql-connectorx --conn <connection_token>

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

Windsurf

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

{
  "mcpServers": {
    "gigamori-mcp-run-sql-connectorx-4dy2macabf": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gigamori/mcp-run-sql-connectorx",
        "run-sql-connectorx",
        "--conn",
        "<connection_token>"
      ]
    }
  }
}

Cline

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

{
  "mcpServers": {
    "gigamori-mcp-run-sql-connectorx-4dy2macabf": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gigamori/mcp-run-sql-connectorx",
        "run-sql-connectorx",
        "--conn",
        "<connection_token>"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например gigamori-mcp-run-sql-connectorx-4dy2macabf.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: gigamori-mcp-run-sql-connectorx-4dy2macabf
    command: uvx
    args:
      - "--from"
      - "git+https://github.com/gigamori/mcp-run-sql-connectorx"
      - "run-sql-connectorx"
      - "--conn"
      - "<connection_token>"

Zed

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

{
  "context_servers": {
    "gigamori-mcp-run-sql-connectorx-4dy2macabf": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gigamori/mcp-run-sql-connectorx",
        "run-sql-connectorx",
        "--conn",
        "<connection_token>"
      ]
    }
  }
}

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

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/gigamori/mcp-run-sql-connectorx",
    "run-sql-connectorx",
    "--conn",
    "<connection_token>"
  ]
}