db-oauth-mcp

Servidor MCP de Node.js (TypeScript, distribuido como una extensión de escritorio .mcpb) que permite a Claude Desktop ejecutar SQL de solo lectura contra una o más bases de datos, protegido por OAuth 2.0 PKCE. Las credenciales son por usuario, de corta duración y nunca se guardan en el disco.

Motores compatibles: MariaDB / MySQL y Microsoft SQL Server. Una sola sesión de OAuth puede exponer cualquier número de conexiones en cualquiera de los motores: el backend decide qué proporcionar.

Este es el puerto a Node de db-oauth-mcp (anteriormente en Go). Mismo contrato de OAuth, misma superficie de herramientas, mismo comportamiento, pero distribuido como un archivo zip neutral para la plataforma sin firma de código, sin compilación cruzada y sin binario nativo.

Estado

En construcción. La implementación en Go en la versión v0.2.x sigue siendo la recomendación actual hasta que este repositorio marque la versión v0.3.0.

Desarrollo

Requiere Node 18+ y 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

Consulta el README del repositorio de Go para conocer el contrato de OAuth, la documentación de las herramientas y las reglas de seguridad específicas del motor, todas las cuales se heredan literalmente aquí.