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

MCP Alchemy превращает Claude Desktop в вашего личного эксперта по базам данных. Он подключается к разным СУБД через SQLAlchemy, чтобы Клод мог смотреть структуру таблиц, подсказывать SQL-запросы и выгружать результаты. Всё это нужно, чтобы работать с данными прямо в диалоге — без переключения между терминалом и интерфейсом, быстрее и удобнее.

Каталог MCP
runekaagaard/mcp-alchemy

runekaagaard/mcp-alchemy

от runekaagaard

MCP инструмент Alchemy для Claude Desktop превращает его в эксперта по базам данных: исследование структуры, написание SQL, анализ больших наборов данных. Поддерживает PostgreSQL, MySQL, SQLite и м...

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

README

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

Версии

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

MCP Alchemy

Status: Actively maintained and in daily use. Tested releases are published to PyPI with git tags, and issues and pull requests are triaged regularly.

Let Claude be your database expert! MCP Alchemy connects Claude Desktop directly to your databases, allowing it to:

Help you explore and understand your database structure
Assist in writing and validating SQL queries
Displays relationships between tables
Analyze large datasets and create reports
Claude Desktop Can analyse and create artifacts for very large datasets using claude-local-files.

Works with PostgreSQL, MySQL, MariaDB, SQLite, Oracle, MS SQL Server, CrateDB, Vertica, and a host of other SQLAlchemy-compatible databases.

MCP Alchemy in action

Installation

Ensure you have uv installed:

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

Usage with Claude Desktop

Add to your claude_desktop_config.json. You need to add the appropriate database driver in the --with parameter.

Note: After a new version release there might be a period of up to 600 seconds while the cache clears locally cached causing uv to raise a versioning error. Restarting the MCP client once again solves the error.

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

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

`2026.10.15.202659`основная	15.10.2026
`2026.10.6.103105`	06.10.2026
`2026.9.5.185701`	05.09.2026
`2026.8.1.2602`	01.08.2026
`2026.7.26.212710`	26.07.2026
`2025.8.15.91819`	15.08.2025
`2025.7.9.172934`	09.07.2025
`2025.6.19.201831`	19.06.2025
`2025.6.19.200917`	19.06.2025
`2025.5.2.210242`	02.05.2025
`2025.5.2.204258`	02.05.2025
`2025.5.2.203949`	02.05.2025
`2025.4.23.194321`	23.04.2025
`2025.4.16.110003`	16.04.2025
`2025.4.16.105708`	16.04.2025
`2025.4.16.103515`	16.04.2025
`2025.4.16.101343`	16.04.2025
`2025.4.16.94727`	16.04.2025
`2025.4.15.223605`	15.04.2025
`2025.4.15.223303`	15.04.2025
`2025.4.15.223041`	15.04.2025
`2025.4.15.222734`	15.04.2025
`2025.4.15.221253`	15.04.2025
`2025.4.15.221140`	15.04.2025
`2025.4.15.220113`	15.04.2025
`2025.4.15.215804`	15.04.2025
`2025.4.9.91234`	09.04.2025
`2025.4.9.91042`	09.04.2025
`2025.4.8.215621`	08.04.2025
`2025.4.8.214659`	08.04.2025
`2025.4.8.214640`	08.04.2025
`2025.4.8.213921`	08.04.2025
`2025.4.8.213457`	08.04.2025
`2025.4.8.213054`	08.04.2025
`2025.4.8.212836`	08.04.2025
`2025.4.8.212652`	08.04.2025
`2025.4.8.210012`	08.04.2025

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

Любой клиент

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

{
  "mcpServers": {
    "runekaagaard-mcp-alchemy-ua3g8s4i4z": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-alchemy==2025.8.15.91819",
        "--refresh-package",
        "mcp-alchemy",
        "mcp-alchemy"
      ],
      "env": {
        "DB_URL": "sqlite:////absolute/path/to/database.db"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "runekaagaard-mcp-alchemy-ua3g8s4i4z": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-alchemy==2025.8.15.91819",
        "--refresh-package",
        "mcp-alchemy",
        "mcp-alchemy"
      ],
      "env": {
        "DB_URL": "sqlite:////absolute/path/to/database.db"
      }
    }
  }
}

VS Code

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

{
  "servers": {
    "runekaagaard-mcp-alchemy-ua3g8s4i4z": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "mcp-alchemy==2025.8.15.91819",
        "--refresh-package",
        "mcp-alchemy",
        "mcp-alchemy"
      ],
      "env": {
        "DB_URL": "sqlite:////absolute/path/to/database.db"
      }
    }
  }
}

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

code --add-mcp "{\"name\":\"runekaagaard-mcp-alchemy-ua3g8s4i4z\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"--from\",\"mcp-alchemy==2025.8.15.91819\",\"--refresh-package\",\"mcp-alchemy\",\"mcp-alchemy\"],\"env\":{\"DB_URL\":\"sqlite:////absolute/path/to/database.db\"}}"

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": {
    "runekaagaard-mcp-alchemy-ua3g8s4i4z": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-alchemy==2025.8.15.91819",
        "--refresh-package",
        "mcp-alchemy",
        "mcp-alchemy"
      ],
      "env": {
        "DB_URL": "sqlite:////absolute/path/to/database.db"
      }
    }
  }
}

Claude Code

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

claude mcp add runekaagaard-mcp-alchemy-ua3g8s4i4z --env DB_URL=sqlite:////absolute/path/to/database.db -- uvx --from mcp-alchemy==2025.8.15.91819 --refresh-package mcp-alchemy mcp-alchemy

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

claude mcp add-json runekaagaard-mcp-alchemy-ua3g8s4i4z "{\"command\":\"uvx\",\"args\":[\"--from\",\"mcp-alchemy==2025.8.15.91819\",\"--refresh-package\",\"mcp-alchemy\",\"mcp-alchemy\"],\"env\":{\"DB_URL\":\"sqlite:////absolute/path/to/database.db\"}}"

Codex

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

codex mcp add runekaagaard-mcp-alchemy-ua3g8s4i4z --env DB_URL=sqlite:////absolute/path/to/database.db -- uvx --from mcp-alchemy==2025.8.15.91819 --refresh-package mcp-alchemy mcp-alchemy

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

[mcp_servers.runekaagaard-mcp-alchemy-ua3g8s4i4z]
command = "uvx"
args = ["--from", "mcp-alchemy==2025.8.15.91819", "--refresh-package", "mcp-alchemy", "mcp-alchemy"]

[mcp_servers.runekaagaard-mcp-alchemy-ua3g8s4i4z.env]
DB_URL = "sqlite:////absolute/path/to/database.db"

Perplexity

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

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

uvx --from mcp-alchemy==2025.8.15.91819 --refresh-package mcp-alchemy mcp-alchemy

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

Windsurf

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

{
  "mcpServers": {
    "runekaagaard-mcp-alchemy-ua3g8s4i4z": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-alchemy==2025.8.15.91819",
        "--refresh-package",
        "mcp-alchemy",
        "mcp-alchemy"
      ],
      "env": {
        "DB_URL": "sqlite:////absolute/path/to/database.db"
      }
    }
  }
}

Cline

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

{
  "mcpServers": {
    "runekaagaard-mcp-alchemy-ua3g8s4i4z": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-alchemy==2025.8.15.91819",
        "--refresh-package",
        "mcp-alchemy",
        "mcp-alchemy"
      ],
      "env": {
        "DB_URL": "sqlite:////absolute/path/to/database.db"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

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

mcpServers:
  - name: runekaagaard-mcp-alchemy-ua3g8s4i4z
    command: uvx
    args:
      - "--from"
      - "mcp-alchemy==2025.8.15.91819"
      - "--refresh-package"
      - "mcp-alchemy"
      - "mcp-alchemy"
    env:
      DB_URL: sqlite:////absolute/path/to/database.db

Zed

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

{
  "context_servers": {
    "runekaagaard-mcp-alchemy-ua3g8s4i4z": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-alchemy==2025.8.15.91819",
        "--refresh-package",
        "mcp-alchemy",
        "mcp-alchemy"
      ],
      "env": {
        "DB_URL": "sqlite:////absolute/path/to/database.db"
      }
    }
  }
}

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

{
  "command": "uvx",
  "args": [
    "--from",
    "mcp-alchemy==2025.8.15.91819",
    "--refresh-package",
    "mcp-alchemy",
    "mcp-alchemy"
  ],
  "env": {
    "DB_URL": "sqlite:////absolute/path/to/database.db"
  }
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx