SQL Server MCP (macOS)

SQL Server MCP (macOS)

TharanaBopeMIT
1 звёзд
SQL Server MCP — сервер для подключения баз данных SQL Server к AI-ассистентам через протокол MCP. Реализован на TypeScript, встраивается в любые MCP-клиенты (Claude Desktop и другие). Версия для macOS использует Docker для запуска SQL Server и чистый JavaScript-драйвер mssql — не требует ODBC или дополнительных библиотек. Сервер построен по принципу RAG (Retrieval-Augmented Generation): он индексирует схему базы данных и позволяет AI-ассистенту быстро находить нужные таблицы, столбцы и связи. В результате разработчики и аналитики могут получать данные и метаинформацию простыми запросами на естественном языке, не переключаясь между окнами. SQL Server MCP поддерживает безопасное выполнение запросов: только SELECT, с ограничением строк и таймаутом, а также защитой от SQL-инъекций. Кеширование схемы с настраиваемым TTL ускоряет повторные обращения к метаданным.
Ai-mlDatabasesCloud-devopsDocker
Открыть на GitHub

Установка

npx -y @tharanabopearachchi/sql-server-mcp-macos

Характеристики

Общее

  • СтатусСообщество
  • РазработчикTharanaBope
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Исследование структуры базы: просмотр баз данных, таблиц, представлений, хранимых процедур.
  • Обнаружение связей: поиск внешних ключей и зависимостей между таблицами.
  • Глобальный поиск по схеме: поиск по имени таблицы, столбца или процедуры во всей базе.
  • Безопасное выполнение запросов: только SELECT, автоматическое ограничение числа строк и таймаут выполнения.
  • Кеширование метаданных: схема кэшируется с TTL 60 минут (настраивается).
  • Защита от инъекций: встроенная проверка запросов, блокировка опасных конструкций.
  • Полная поддержка macOS: работа через Docker, драйвер mssql, никаких нативных зависимостей.

Как подключить

  1. Установите сервер глобально через npx:
    2. npx -y @tharanabopearachchi/sql-server-mcp-macos
  2. Добавьте конфигурацию в MCP-клиент (пример для Claude Desktop, файл ~/Library/Application Support/Claude/claude_desktop_config.json):
    3. { "mcpServers": { "sql-server-mcp": { "command": "npx", "args": ["-y", "@tharanabopearachchi/sql-server-mcp-macos"], "env": { "DB_USER": "sa", "DB_PASSWORD": "your_strong_password", "DB_SERVER": "localhost", "DB_PORT": "1433", "DB_NAME": "your_database" } } } }
  3. Перезапустите клиент. Теперь AI-ассистент может выполнять запросы к вашей базе данных SQL Server.

Примеры запросов

  • «Покажи список всех таблиц в базе данных Sales.»
  • «Найди все таблицы, в которых есть столбец Email.»
  • «Выведи структуру таблицы Orders с указанием внешних ключей.»
  • «Сделай SELECT первых 10 строк из Products, где цена больше 100.»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Совместимые клиенты: Claude Desktop, любой MCP-клиент с поддержкой stdio
  • Платформа: macOS (требуется Docker для SQL Server)
  • Драйвер: mssql (pure JavaScript, без нативных зависимостей)

Поделиться