Сервер базы данных MCP

Этот сервер MCP (Model Context Protocol) предоставляет Клоду возможности доступа к базам данных, поддерживая базы данных SQLite, SQL Server и PostgreSQL.

Установка

Клонируйте репозиторий:

git clone https://github.com/executeautomation/database-server.git cd database-server

Установить зависимости:

npm install

Создайте проект:

npm run build

Related MCP server: SQLite MCP Server

Варианты использования

Использовать этот MCP-сервер с Клодом можно двумя способами:

Прямое использование : установите пакет глобально и используйте его напрямую.
Локальная разработка : запуск из локальной среды разработки

Прямое использование с пакетом NPM

Самый простой способ использовать этот MCP-сервер — установить его глобально:

npm install -g @executeautomation/database-server

Это позволяет вам использовать сервер напрямую, без его локальной сборки.

Настройка локального развития

Если вы хотите изменить код или запустить его из локальной среды:

Клонируйте и соберите репозиторий, как показано в разделе «Установка».
Запустите сервер, используя команды, указанные в разделе «Использование» ниже.

Использование

База данных SQLite

Для использования с базой данных SQLite:

node dist/src/index.js /path/to/your/database.db

База данных SQL-сервера

Для использования с базой данных SQL Server:

node dist/src/index.js --sqlserver --server <server-name> --database <database-name> [--user <username> --password <password>]

Необходимые параметры:

--server : имя хоста или IP-адрес SQL Server
--database : Имя базы данных

Необязательные параметры:

--user : Имя пользователя для аутентификации SQL Server (если не указано, будет использоваться аутентификация Windows)
--password : Пароль для аутентификации SQL Server
--port : Номер порта (по умолчанию: 1433)

База данных PostgreSQL

Для использования с базой данных PostgreSQL:

node dist/src/index.js --postgresql --host <host-name> --database <database-name> [--user <username> --password <password>]

Необходимые параметры:

--host : имя хоста PostgreSQL или IP-адрес
--database : Имя базы данных

Необязательные параметры:

--user : Имя пользователя для аутентификации PostgreSQL
--password : Пароль для аутентификации PostgreSQL
--port : Номер порта (по умолчанию: 5432)
--ssl : Включить SSL-соединение (true/false)
--connection-timeout : Время ожидания соединения в миллисекундах (по умолчанию: 30000)

Настройка рабочего стола Claude

Конфигурация прямого использования

Если вы установили пакет глобально, настройте Claude Desktop следующим образом:

{ "mcpServers": { "sqlite": { "command": "npx", "args": [ "-y", "@executeautomation/database-server", "/path/to/your/database.db" ] }, "sqlserver": { "command": "npx", "args": [ "-y", "@executeautomation/database-server", "--sqlserver", "--server", "your-server-name", "--database", "your-database-name", "--user", "your-username", "--password", "your-password" ] }, "postgresql": { "command": "npx", "args": [ "-y", "@executeautomation/database-server", "--postgresql", "--host", "your-host-name", "--database", "your-database-name", "--user", "your-username", "--password", "your-password" ] } } }

Конфигурация локального развития

Для локальной разработки настройте Claude Desktop на использование локально собранной версии:

{ "mcpServers": { "sqlite": { "command": "node", "args": [ "/absolute/path/to/mcp-database-server/dist/src/index.js", "/path/to/your/database.db" ] }, "sqlserver": { "command": "node", "args": [ "/absolute/path/to/mcp-database-server/dist/src/index.js", "--sqlserver", "--server", "your-server-name", "--database", "your-database-name", "--user", "your-username", "--password", "your-password" ] }, "postgresql": { "command": "node", "args": [ "/absolute/path/to/mcp-database-server/dist/src/index.js", "--postgresql", "--host", "your-host-name", "--database", "your-database-name", "--user", "your-username", "--password", "your-password" ] } } }

Файл конфигурации Claude Desktop обычно находится по адресу:

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

Доступные инструменты базы данных

Сервер базы данных MCP предоставляет следующие инструменты, которые может использовать Клод:

Инструмент	Описание	Требуемые параметры
`read_query`	Выполнение запросов SELECT для чтения данных	`query` : оператор SQL SELECT
`write_query`	Выполнение запросов INSERT, UPDATE или DELETE	`query` : оператор модификации SQL
`create_table`	Создать новые таблицы в базе данных	`query` : оператор CREATE TABLE
`alter_table`	Изменить существующую схему таблицы	`query` : оператор ALTER TABLE
`drop_table`	Удалить таблицу из базы данных	`table_name` : Имя таблицы. `confirm` : Флаг безопасности (должен быть истинным)
`list_tables`	Получить список всех таблиц	Никто
`describe_table`	Просмотр информации о схеме для таблицы	`table_name` : Имя таблицы
`export_query`	Экспорт результатов запроса в формате CSV/JSON	`query` : SQL SELECT `format` оператора: "csv" или "json"
`append_insight`	Добавьте бизнес-информацию в заметку	`insight` : Текст проницательности
`list_insights`	Список всех бизнес-идей	Никто

Практические примеры использования этих инструментов с Клодом см. в разделе Примеры использования .

Дополнительная документация

Руководство по настройке SQL Server : Подробности подключения к базам данных SQL Server
Руководство по настройке PostgreSQL : Подробности подключения к базам данных PostgreSQL
Примеры использования : Примеры запросов и команд для использования с Клодом

Разработка

Чтобы запустить сервер в режиме разработки:

npm run dev

Чтобы отслеживать изменения в процессе разработки:

npm run watch

Требования

Node.js 18+
Для подключения к SQL Server: SQL Server 2012 или более поздняя версия
Для подключения к PostgreSQL: PostgreSQL 9.5 или более поздняя версия

Лицензия

Массачусетский технологический институт

ExecuteAutomation Database Server