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

Этот MCP-сервер соединяет AI-ассистентов напрямую с любыми базами данных через ODBC и SQLAlchemy. Он даёт агенту возможность получать схемы, таблицы, описания колонок, выполнять SQL-запросы и хранимые процедуры. Вместо того чтобы копаться в документации вручную, разработчик просто подключает сервер — и ассистент сам разбирается со структурой данных. Особенно полезен для Virtuoso, PostgreSQL, MySQL и SQLite.

Каталог MCP
openlink/mcp-server-sqlalchemy

openlink/mcp-server-sqlalchemy

от openlinksoftware

MCP сервер для ODBC через SQLAlchemy даёт доступ к базам: схемы, таблицы, описания, запросы SQL, SPARQL и SPASQL. Работает с Virtuoso, PostgreSQL, MySQL, SQLite. Помогает разработчикам интегрировать данные с AI.

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

README

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

Версии

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

MCP Server ODBC via SQLAlchemy

A lightweight MCP (Model Context Protocol) server for ODBC built with FastAPI, pyodbc, and SQLAlchemy. This server is compatible with Virtuoso DBMS and other DBMS backends that implement a SQLAlchemy provider.

mcp-client-and-servers|648x499

Features

Get Schemas: Fetch and list all schema names from the connected database.
Get Tables: Retrieve table information for specific schemas or all schemas.
Describe Table: Generate a detailed description of table structures, including:
- Column names and data types
- Nullable attributes
- Primary and foreign keys
Search Tables: Filter and retrieve tables based on name substrings.
Execute Stored Procedures: In the case of Virtuoso, execute stored procedures and retrieve results.
Execute Queries:
- JSONL result format: Optimized for structured responses.
- Markdown table format: Ideal for reporting and visualization.

Prerequisites

Install uv:
```
pip install uv
```
Or use Homebrew:
```
brew install uv
```
unixODBC Runtime Environment Checks:
Check installation configuration (i.e., location of key INI files) by running: odbcinst -j
List available data source names by running: odbcinst -q -s

ODBC DSN Setup: Configure your ODBC Data Source Name (~/.odbc.ini) for the target database. Example for Virtuoso DBMS:

[VOS]
Description = OpenLink Virtuoso
Driver = /path/to/virtodbcu_r.so
Database = Demo
Address = localhost:1111
WideAsUTF16 = Yes

SQLAlchemy URL Binding: Use the format:
```
virtuoso+pyodbc://user:password@VOS
```

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

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

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

Любой клиент

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

{
  "mcpServers": {
    "openlink-mcp-server-sqlalchemy-lhc4es8u1a": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-sqlalchemy-server",
        "run",
        "mcp-sqlalchemy-server"
      ],
      "env": {
        "ODBC_DSN": "dsn_name",
        "ODBC_USER": "username",
        "ODBC_PASSWORD": "password",
        "API_KEY": "sk-xxx"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "openlink-mcp-server-sqlalchemy-lhc4es8u1a": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-sqlalchemy-server",
        "run",
        "mcp-sqlalchemy-server"
      ],
      "env": {
        "ODBC_DSN": "dsn_name",
        "ODBC_USER": "username",
        "ODBC_PASSWORD": "password",
        "API_KEY": "sk-xxx"
      }
    }
  }
}

VS Code

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

{
  "servers": {
    "openlink-mcp-server-sqlalchemy-lhc4es8u1a": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-sqlalchemy-server",
        "run",
        "mcp-sqlalchemy-server"
      ],
      "env": {
        "ODBC_DSN": "dsn_name",
        "ODBC_USER": "username",
        "ODBC_PASSWORD": "password",
        "API_KEY": "sk-xxx"
      }
    }
  }
}

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

code --add-mcp "{\"name\":\"openlink-mcp-server-sqlalchemy-lhc4es8u1a\",\"type\":\"stdio\",\"command\":\"uv\",\"args\":[\"--directory\",\"/path/to/mcp-sqlalchemy-server\",\"run\",\"mcp-sqlalchemy-server\"],\"env\":{\"ODBC_DSN\":\"dsn_name\",\"ODBC_USER\":\"username\",\"ODBC_PASSWORD\":\"password\",\"API_KEY\":\"sk-xxx\"}}"

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": {
    "openlink-mcp-server-sqlalchemy-lhc4es8u1a": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-sqlalchemy-server",
        "run",
        "mcp-sqlalchemy-server"
      ],
      "env": {
        "ODBC_DSN": "dsn_name",
        "ODBC_USER": "username",
        "ODBC_PASSWORD": "password",
        "API_KEY": "sk-xxx"
      }
    }
  }
}

Claude Code

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

claude mcp add openlink-mcp-server-sqlalchemy-lhc4es8u1a --env ODBC_DSN=dsn_name --env ODBC_USER=username --env ODBC_PASSWORD=password --env API_KEY=sk-xxx -- uv --directory /path/to/mcp-sqlalchemy-server run mcp-sqlalchemy-server

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

claude mcp add-json openlink-mcp-server-sqlalchemy-lhc4es8u1a "{\"command\":\"uv\",\"args\":[\"--directory\",\"/path/to/mcp-sqlalchemy-server\",\"run\",\"mcp-sqlalchemy-server\"],\"env\":{\"ODBC_DSN\":\"dsn_name\",\"ODBC_USER\":\"username\",\"ODBC_PASSWORD\":\"password\",\"API_KEY\":\"sk-xxx\"}}"

Codex

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

codex mcp add openlink-mcp-server-sqlalchemy-lhc4es8u1a --env ODBC_DSN=dsn_name --env ODBC_USER=username --env ODBC_PASSWORD=password --env API_KEY=sk-xxx -- uv --directory /path/to/mcp-sqlalchemy-server run mcp-sqlalchemy-server

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

[mcp_servers.openlink-mcp-server-sqlalchemy-lhc4es8u1a]
command = "uv"
args = ["--directory", "/path/to/mcp-sqlalchemy-server", "run", "mcp-sqlalchemy-server"]

[mcp_servers.openlink-mcp-server-sqlalchemy-lhc4es8u1a.env]
ODBC_DSN = "dsn_name"
ODBC_USER = "username"
ODBC_PASSWORD = "password"
API_KEY = "sk-xxx"

Perplexity

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

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

uv --directory /path/to/mcp-sqlalchemy-server run mcp-sqlalchemy-server

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

Windsurf

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

{
  "mcpServers": {
    "openlink-mcp-server-sqlalchemy-lhc4es8u1a": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-sqlalchemy-server",
        "run",
        "mcp-sqlalchemy-server"
      ],
      "env": {
        "ODBC_DSN": "dsn_name",
        "ODBC_USER": "username",
        "ODBC_PASSWORD": "password",
        "API_KEY": "sk-xxx"
      }
    }
  }
}

Cline

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

{
  "mcpServers": {
    "openlink-mcp-server-sqlalchemy-lhc4es8u1a": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-sqlalchemy-server",
        "run",
        "mcp-sqlalchemy-server"
      ],
      "env": {
        "ODBC_DSN": "dsn_name",
        "ODBC_USER": "username",
        "ODBC_PASSWORD": "password",
        "API_KEY": "sk-xxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

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

mcpServers:
  - name: openlink-mcp-server-sqlalchemy-lhc4es8u1a
    command: uv
    args:
      - "--directory"
      - "/path/to/mcp-sqlalchemy-server"
      - "run"
      - "mcp-sqlalchemy-server"
    env:
      ODBC_DSN: dsn_name
      ODBC_USER: username
      ODBC_PASSWORD: password
      API_KEY: sk-xxx

Zed

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

{
  "context_servers": {
    "openlink-mcp-server-sqlalchemy-lhc4es8u1a": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-sqlalchemy-server",
        "run",
        "mcp-sqlalchemy-server"
      ],
      "env": {
        "ODBC_DSN": "dsn_name",
        "ODBC_USER": "username",
        "ODBC_PASSWORD": "password",
        "API_KEY": "sk-xxx"
      }
    }
  }
}

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

{
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/mcp-sqlalchemy-server",
    "run",
    "mcp-sqlalchemy-server"
  ],
  "env": {
    "ODBC_DSN": "dsn_name",
    "ODBC_USER": "username",
    "ODBC_PASSWORD": "password",
    "API_KEY": "sk-xxx"
  }
}