MCP server for AnalyticDB MySQL via OpenAPI and direct SQL connection
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"adb-mysql-mcp-server","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# AnalyticDB for MySQL MCP Server English | [中文](README_zh.md) AnalyticDB for MySQL MCP Server is a universal interface between AI Agents and [AnalyticDB MySQL](https://www.alibabacloud.com/zh/product/analyticdb-for-mysql). It provides two tool groups: - **SQL Tools & Resources** (`sql` group): Connect directly to ADB MySQL clusters to execute SQL, view execution plans, and browse database metadata. The `sql` group is only a tool-group switch; `execute_sql` runs in read-only mode by default, and full SQL execution mode requires the additional explicit setting `ENABLE_SQL_WRITE_TOOLS=true`. - **OpenAPI Tools** (`openapi` group): Manage clusters, whitelists, accounts, networking, monitoring, diagnostics, and audit logs via Alibaba Cloud OpenAPI. Read-only tools are annotated with `ToolAnnotations(readOnlyHint=True)` per the MCP protocol, allowing clients to distinguish them from mutating operations. ## 一、Prerequisites - Python >= 3.13 - [uv](https://docs.astral.sh/uv/getting-started/installation/) (recommended package manager and runner) - Alibaba Cloud AccessKey (required for OpenAPI tools) - Optional: ADB MySQL connection credentials (for SQL tools in direct-connection mode) ## 二、Quick Start ### 2.0 Choose a Configuration Choose the tool groups and extra switches for your scenario before copying a client configuration: | Scenario | Tool groups | Extra switch | Best for | | --- | --- | --- | --- | | Read-only SQL queries, EXPLAIN, and metadata browsing | `sql` | None | Recommended default for querying, troubleshooting, and read-only analysis | | Full SQL execution through `execute_sql` | `sql` | `ENABLE_SQL_WRITE_TOOLS=true` | INSERT/UPDATE/DELETE/DDL/multi-statement SQL when the MCP client is trusted | | OpenAPI cluster management tools + SQL read tools | `openapi,sql` | Alibaba Cloud AK/SK + `ADB_MYSQL_*` direct connection settings | Cluster, account, whitelist, diagnostics, and monitoring operations while keeping SQL read access | | OpenAPI + full SQL e…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.