A Model Context Protocol (MCP) server which provides tools and resources, allowing AI agent to interact with Alibaba cloud PolarDB-X databases.
Most database access work still happens through a UI a human drives. Polardbx MCP server moves it into the conversation instead. A Model Context Protocol (MCP) server which provides tools and resources, allowing AI agent to interact with Alibaba cloud PolarDB-X databases.
bash npm install npm run build 3. Configure the PolarDB-X connection in environment variable file .env: POLARDB_X_HOST=your_database_host POLARDB_X_PORT=your_database_port POLARDB_X_USER=your_database_user POLARDB_X_PASSWORD=your_database_password POLARDB_X_DATABASE=your_database_nameInstallation goes through your MCP client rather than a global install: point it at polardbx-mcp on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
The server publishes 3 tools. What each one is for:
query — Run a SQL query on PolarDB-XTools — The Tools tool exposed by this serverResources — The server provides schema information for each table in the database: - Table Schemas (polardbx://<database_name>/<table_name>) - JSON schemaConfiguration is passed through the environment: POLARDB_X_HOST, POLARDB_X_PORT, POLARDB_X_USER, POLARDB_X_PASSWORD, POLARDB_X_DATABASE. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Among the database access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Polardbx's toolset — query, Tools, Resources — is a fair guide to whether it matches your workflow. It is maintained by aliyun; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Polardbx's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| query | Run a SQL query on PolarDB-X |
| Tools | The Tools tool exposed by this server. |
| Resources | The server provides schema information for each table in the database: - Table Schemas (polardbx://<database_name>/<table_name>) - JSON schema information for each table - Includes column names and data types |
{
"mcpServers": {
"alibabacloud-polardbx": {
"command": "npx",
"args": ["-y", "polardbx-mcp"],
"env": {
"POLARDB_X_HOST": "your-value",
"POLARDB_X_PORT": "your-value",
"POLARDB_X_USER": "your-value",
"POLARDB_X_PASSWORD": "your-value",
"POLARDB_X_DATABASE": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| POLARDB_X_HOST | Endpoint or connection string the server talks to. | Optional |
| POLARDB_X_PORT | Configuration value read at startup. | Optional |
| POLARDB_X_USER | Configuration value read at startup. | Optional |
| POLARDB_X_PASSWORD | Configuration value read at startup. | Optional |
| POLARDB_X_DATABASE | Configuration value read at startup. | Optional |
Read-only SQL access to Postgres — let your assistant inspect schemas and answer questions from real data.
Manage your whole Supabase project in conversation — database, auth, storage, Edge Functions and branches.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Official MongoDB server covering data, schemas and Atlas management — from find queries to spinning up clusters.
Serverless Postgres with database branching — point your assistant at Neon and let it work on disposable copies.