mssql-mcp

Ein schreibgeschützter Microsoft SQL Server MCP-Server, der Verbindungsdetails zum Zeitpunkt des Tool-Aufrufs aus dem AWS Secrets Manager bezieht — es werden außer der Secret-Referenz selbst keine Daten von der Festplatte oder aus Umgebungsvariablen gelesen.

Plattformübergreifend: Es handelt sich um einen reinen JavaScript-MCP-Server (keine nativen oder ODBC-Abhängigkeiten), daher läuft er über npx identisch auf macOS, Linux und Windows.

Konfiguration in .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"
      }
    }
  }
}

Standard-AWS-SDK-Umgebungsvariablen (AWS_PROFILE, AWS_ACCESS_KEY_ID usw.) werden über die Standard-Credential-Provider-Kette berücksichtigt. Die meisten Benutzer müssen lediglich aws sso login ausführen, um aktuell zu sein.

Related MCP server: MSSQL MCP Python Server

Erforderliches Secret-JSON

Der Secret-Wert muss ein JSON-Dokument mit mindestens den folgenden Feldern sein:

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

database kann auch als dbname bereitgestellt werden — der Feldname, den AWS in seiner integrierten RDS-Anmeldedaten-Secret-Vorlage verwendet. Wenn beide vorhanden sind, hat database Vorrang.

Optionale Felder (mit Standardwerten):

Das Vertrauen in TLS-Zertifikate wird nicht aus dem Secret gelesen — setzen Sie stattdessen TRUST_SERVER_CERTIFICATE im env-Block des MCP-Servers. Jedes trustServerCertificate-Feld im Secret-JSON wird ignoriert.

Konzeptionell schreibgeschützt

Dieser Server kann keine Daten einfügen, aktualisieren oder löschen. Zwei Ebenen erzwingen dies:

1. Das run_select-Tool lehnt lexikalisch alles ab, was keine einzelne SELECT- oder WITH (CTE)-Anweisung ist — einschließlich INSERT, UPDATE, DELETE, EXEC, MERGE, DROP, ALTER, SELECT INTO usw.

2. Kein anderes Tool gibt schreibendes SQL aus. get_procedure_definition gibt den Quellcode der Prozedur zurück — es führt keine Prozeduren aus.

Hinweis: Betrachten Sie die lexikalische Prüfung als UX, nicht als Sicherheitsgrenze. Konfigurieren Sie zu Ihrer eigenen Sicherheit die Anmeldedaten, die Sie im Secrets Manager hinterlegen, als schreibgeschütztes Datenbank-Login — eines, das nur SELECT und VIEW DEFINITION erlaubt. Auf diese Weise wird ein versehentlicher Schreibvorgang (oder ein zukünftiger Fehler hier) vom SQL Server selbst abgelehnt.

Aktualisieren von AWS-Anmeldedaten ohne Neustart

Da der Server die Standard-AWS-Credential-Kette verwendet, kann eine abgelaufene SSO-Sitzung wiederhergestellt werden, ohne Claude oder den MCP-Server neu zu starten:

1. Führen Sie aws sso login in einem beliebigen Terminal aus.

2. Bitten Sie Claude, das Tool refresh_secret aufzurufen.

3. Arbeiten Sie weiter.

Wenn ein Tool-Aufruf aufgrund der AWS-Authentifizierung fehlschlägt, wird Ihnen die Fehlermeldung dies genau mitteilen und denselben Ablauf vorschlagen. Fehler sind mit stabilen Präfixen gekennzeichnet:

Tools

Lokale Entwicklung

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"]