db-oauth-mcp

OAuth 2.0 PKCE로 보호되는 하나 이상의 데이터베이스에 대해 Claude Desktop이 읽기 전용 SQL을 실행할 수 있도록 하는 Node.js MCP 서버(TypeScript, .mcpb 데스크톱 확장 프로그램으로 배포)입니다. 자격 증명은 사용자별로 생성되며 수명이 짧고 디스크에 저장되지 않습니다.

지원되는 엔진: MariaDB / MySQL 및 Microsoft SQL Server. 단일 OAuth 세션으로 두 엔진 전반에 걸쳐 원하는 수의 연결을 노출할 수 있으며, 백엔드에서 무엇을 제공할지 결정합니다.

이 프로젝트는 db-oauth-mcp(이전 Go 버전)의 Node 포트입니다. 동일한 OAuth 계약, 동일한 도구 인터페이스, 동일한 동작을 제공하지만, 코드 서명, 교차 컴파일, 네이티브 바이너리가 필요 없는 플랫폼 중립적인 zip 파일로 배포됩니다.

상태

제작 중입니다. 이 저장소가 v0.3.0을 태그하기 전까지는 v0.2.x의 Go 구현을 사용하는 것을 권장합니다.

개발

Node 18+ 및 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

OAuth 계약, 도구 문서 및 엔진별 안전 규칙은 Go 저장소 README를 참조하십시오. 이 모든 내용은 여기서 그대로 상속됩니다.