db-oauth-mcp

Node.js MCP-сервер (TypeScript, распространяется как расширение для рабочего стола .mcpb), который позволяет Claude Desktop выполнять SQL-запросы только для чтения к одной или нескольким базам данных, защищенным с помощью OAuth 2.0 PKCE. Учетные данные являются индивидуальными для каждого пользователя, кратковременными и никогда не сохраняются на диске.

Поддерживаемые движки: MariaDB / MySQL и Microsoft SQL Server. Один сеанс OAuth может предоставлять доступ к любому количеству подключений для любого из этих движков — бэкенд определяет, что именно предоставить.

Это порт на Node.js проекта db-oauth-mcp (ранее на Go). Тот же контракт OAuth, тот же набор инструментов, то же поведение, но распространяется в виде одного платформонезависимого zip-архива без подписи кода, без кросс-компиляции и без нативных бинарных файлов.

Статус

В разработке. Реализация на Go версии v0.2.x остается текущей рекомендацией до тех пор, пока в этом репозитории не будет отмечена версия v0.3.0.

Разработка

Требуются 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

См. README репозитория на Go для ознакомления с контрактом OAuth, документацией по инструментам и правилами безопасности для конкретных движков, которые полностью унаследованы здесь.