universal-db-mcp-connector — Claude Code skill
The universal-db-mcp-connector skill stands up an MCP server against your database, so the assistant writes and runs queries itself. It covers 17 database types, among them MySQL, PostgreSQL and MongoDB.
no license 203 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill universal-db-mcp-connector -a claude-codeWhat universal-db-mcp-connector does
The skill installs the universal-db-mcp server and shows where to register it with your assistant. Once it is wired up you ask in plain language, and the assistant fetches the schema and runs the query. Types on the list include MySQL, PostgreSQL, MongoDB, Redis, Oracle, SQL Server, SQLite, ClickHouse and TiDB, plus Dameng, KingbaseES and GaussDB.
Two modes are covered. Under stdio the server is an MCP process declared through command and args in claude_desktop_config.json or .cursor/config.json. Under http it runs as a service with SSE and Streamable HTTP and exposes REST routes /api/health, /api/connect and /api/query for remote clients and Dify.
Passwords in the examples come from the environment (${DB_PASSWORD}) instead of sitting in the config file. --type is the only argument marked required; flags such as --port, --pool-size and --cache-ttl carry defaults. The sample configs also switch on --readonly, which keeps the assistant from writing to your tables.
What it helps with
- Point Claude Desktop at the production MySQL instance and ask what is slow
- Count last week's orders in PostgreSQL without writing SQL by hand
- Hand a local SQLite file to the assistant inside Cursor
- Run the HTTP mode behind an API key for a remote client
- Turn on
--readonlyso the assistant cannot change rows
Example prompts for the agent
- Wire up my local
myappMySQL database to Claude Desktop over MCP, read-only. - Start the connector in HTTP mode on port 3000 using the keys in
API_KEYS. - Write a Cursor config for PostgreSQL at
analytics.example.com, schemapublic, schema cache 600 seconds.
How to install universal-db-mcp-connector
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill universal-db-mcp-connector -a claude-code2Manually: put the files in place
~/.claude/skills/universal-db-mcp-connector/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/universal-db-mcp-connector/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill universal-db-mcp-connector -a codex2Manually: put the files in place
.agents/skills/universal-db-mcp-connector/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill universal-db-mcp-connector -a cursor2Manually: put the files in place
.cursor/skills/universal-db-mcp-connector/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/universal-db-mcp-connector2Manually: put the files in place
.github/skills/universal-db-mcp-connector/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill universal-db-mcp-connector -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/universal-db-mcp-connectorManually: put the files in place
.devin/skills/universal-db-mcp-connector/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill universal-db-mcp-connector -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about universal-db-mcp-connector
How do I install universal-db-mcp-connector in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill universal-db-mcp-connector -a claude-code. The skill lands at ~/.claude/skills/universal-db-mcp-connector/SKILL.md.
What does this skill do?
It documents how to register the universal-db-mcp server with your assistant and supplies working configs, so the assistant can reach a database and answer questions with queries.
stdio or HTTP mode — which one applies?
stdio runs the server as a process inside the client, which suits Claude Desktop and Cursor. HTTP runs it as a standalone service with SSE, Streamable HTTP and REST routes for remote clients such as Dify.