mssql-mcp

MCP-сервер для Microsoft SQL Server с правами только на чтение, использующий данные для подключения из AWS Secrets Manager во время вызова инструмента — с диска или из переменных окружения не считывается ничего, кроме самой ссылки на секрет.

Кроссплатформенность: это MCP-сервер на чистом JavaScript (без нативных зависимостей или ODBC), поэтому он работает одинаково в macOS, Linux и Windows через npx.

Настройка в .claude.json

{
  "mcpServers": {
    "my-db": {
      "command": "npx",
      "args": ["-y", "@dhipskind253/mssql-mcp"],
      "env": {
        "AWS_ACCOUNT_ID": "123456789012",
        "SECRET_NAME": "my-aws-secret",
        "AWS_REGION": "us-east-1",
        "TRUST_SERVER_CERTIFICATE": "false"
      }
    }
  }
}

Стандартные переменные окружения AWS SDK (AWS_PROFILE, AWS_ACCESS_KEY_ID и т. д.) учитываются через стандартную цепочку провайдеров учетных данных. Большинству пользователей достаточно выполнить aws sso login.

Related MCP server: MSSQL MCP Python Server

Требуемый JSON секрета

Значение секрета должно быть JSON-документом как минимум со следующими полями:

{
  "host": "myserver.database.windows.net",
  "port": 1433,
  "database": "mydb",
  "username": "ro_user",
  "password": "..."
}

database также может быть указано как dbname — это имя поля, которое AWS использует в своем встроенном шаблоне секретов для учетных данных RDS. Если присутствуют оба, приоритет у database.

Необязательные поля (указаны значения по умолчанию):

Доверие к TLS-сертификату не считывается из секрета — вместо этого установите TRUST_SERVER_CERTIFICATE в блоке env MCP-сервера. Любое поле trustServerCertificate в JSON секрета игнорируется.

Разработано с правами только на чтение

Этот сервер не может вставлять, обновлять или удалять данные. Это обеспечивается двумя уровнями защиты:

1. Инструмент run_select лексически отклоняет все, что не является одиночным оператором SELECT или WITH (CTE) — включая INSERT, UPDATE, DELETE, EXEC, MERGE, DROP, ALTER, SELECT INTO и т. д.

2. Ни один другой инструмент не выполняет SQL-запросы на запись. get_procedure_definition возвращает исходный код процедуры — он не выполняет процедуры.

Примечание: рассматривайте лексическую проверку как UX, а не как границу безопасности. В качестве любезности к самому себе в будущем, настройте учетные данные, которые вы помещаете в Secrets Manager, как логин базы данных только для чтения — только с правами SELECT и VIEW DEFINITION. Таким образом, случайная запись (или будущая ошибка здесь) будет отклонена самим SQL Server.

Обновление учетных данных AWS без перезапуска

Поскольку сервер использует стандартную цепочку учетных данных AWS, истекший сеанс SSO можно восстановить без перезапуска Claude или MCP-сервера:

1. Выполните aws sso login в любом терминале.

2. Попросите Claude вызвать инструмент refresh_secret.

3. Продолжайте работу.

Если вызов инструмента завершится ошибкой из-за аутентификации AWS, сообщение об ошибке точно укажет на это и предложит выполнить те же действия. Ошибки помечены стабильными префиксами:

Инструменты

Локальная разработка

npm install
npm run build
# point your .claude.json command at the local build:
#   "command": "node",
#   "args": ["/absolute/path/to/mssql-mcp/dist/index.js"]