db-oauth-mcp

Node.js MCP-Server (TypeScript, verteilt als .mcpb Desktop-Erweiterung), der es Claude Desktop ermöglicht, schreibgeschützte SQL-Abfragen gegen eine oder mehrere Datenbanken auszuführen, geschützt durch OAuth 2.0 PKCE. Die Anmeldedaten sind benutzerspezifisch, kurzlebig und werden niemals auf der Festplatte gespeichert.

Unterstützte Engines: MariaDB / MySQL und Microsoft SQL Server. Eine einzige OAuth-Sitzung kann eine beliebige Anzahl von Verbindungen über beide Engines hinweg bereitstellen – das Backend entscheidet, was ausgegeben wird.

Dies ist die Node-Portierung von db-oauth-mcp (zuvor Go). Gleicher OAuth-Vertrag, gleiche Tool-Oberfläche, gleiches Verhalten – aber verteilt als ein plattformneutrales Zip ohne Codesignierung, ohne Cross-Kompilierung und ohne native Binärdatei.

Status

In Arbeit. Die Go-Implementierung unter v0.2.x bleibt die aktuelle Empfehlung, bis dieses Repository v0.3.0 markiert.

Entwicklung

Erfordert Node 18+ und pnpm 10+.

pnpm install
pnpm run typecheck
pnpm run test
pnpm run build
OAUTH_AUTHORIZE_URL=https://auth.example.com/mcp/authorize \
OAUTH_API_BASE_URL=https://api.example.com \
LOG_LEVEL=debug \
node dist/server.js

Siehe das Go-Repo README für den OAuth-Vertrag, die Tool-Dokumentation und die enginespezifischen Sicherheitsregeln, die hier alle wortwörtlich übernommen wurden.