MySQL Legacy MCP Setup & Guide
io.github.Rufflet/mysql-legacy-mcp · v0.2.1
Inspect and query MySQL 5.0–5.6; opt-in INSERT/UPDATE/DELETE/DDL. Live-verified 5.0–8.0.
Copy the install config on this page first, then verify docs and permissions upstream.
Overview
Inspect and query MySQL 5.0–5.6; opt-in INSERT/UPDATE/DELETE/DDL. Live-verified 5.0–8.0. MySQL Legacy MCP is a MCP Server listed from MCP Registry. Transports: stdio. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.
Use cases
AgentHub Verified AvailabilityTested & Ready
Automated pipeline validated install commands, protocol & client compatibility
Copy by platform
Choose your platform
- Open or create .cursor/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets (see Environment variables below)
- Save, then Cmd+Shift+P → Reload Window
Pre-fill Environment Variables (Optional)
{
"mcpServers": {
"mysql-legacy-mcp": {
"command": "npx",
"args": [
"-y",
"mysql-legacy-mcp"
],
"env": {
"MYSQL_LEGACY_HOST": "<MYSQL_LEGACY_HOST>",
"MYSQL_LEGACY_USER": "<MYSQL_LEGACY_USER>",
"MYSQL_LEGACY_PASSWORD": "<MYSQL_LEGACY_PASSWORD>"
}
}
}
}Setup tutorial
- Open the MySQL Legacy MCP page and confirm this MCP Server (source: MCP Registry).
- Copy the Cursor, Claude Code, or VS Code snippet.
- Merge it into mcpServers and replace env placeholders with real secrets.
- Reload the window, then call the MCP tools from your agent chat.
Install commands
Install commands and setup steps are in the HTML so search engines and no-JS browsers can read them without running client JavaScript.
Claude Code (local)
- Install Claude Code CLI
- Copy the command below, replace <placeholders> with real env values, then run in terminal
- See Environment variables below if listed
claude mcp add mysql-legacy-mcp --env MYSQL_LEGACY_HOST=<MYSQL_LEGACY_HOST> --env MYSQL_LEGACY_USER=<MYSQL_LEGACY_USER> --env MYSQL_LEGACY_PASSWORD=<MYSQL_LEGACY_PASSWORD> -- npx -y mysql-legacy-mcpCursor — .cursor/mcp.json (local)
- Open or create .cursor/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets (see Environment variables below)
- Save, then Cmd+Shift+P → Reload Window
{
"mcpServers": {
"mysql-legacy-mcp": {
"command": "npx",
"args": [
"-y",
"mysql-legacy-mcp"
],
"env": {
"MYSQL_LEGACY_HOST": "<MYSQL_LEGACY_HOST>",
"MYSQL_LEGACY_USER": "<MYSQL_LEGACY_USER>",
"MYSQL_LEGACY_PASSWORD": "<MYSQL_LEGACY_PASSWORD>"
}
}
}
}VS Code — .vscode/mcp.json (local)
- Install GitHub Copilot in VS Code with MCP support
- Open or create .vscode/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets
- Save and Developer: Reload Window
{
"mcpServers": {
"mysql-legacy-mcp": {
"command": "npx",
"args": [
"-y",
"mysql-legacy-mcp"
],
"env": {
"MYSQL_LEGACY_HOST": "<MYSQL_LEGACY_HOST>",
"MYSQL_LEGACY_USER": "<MYSQL_LEGACY_USER>",
"MYSQL_LEGACY_PASSWORD": "<MYSQL_LEGACY_PASSWORD>"
}
}
}
}Claude Desktop — claude_desktop_config.json (local)
- Open Claude Desktop claude_desktop_config.json (see remote guide for paths)
- Click Copy config and merge under mcpServers
- Replace <placeholders> in env with real secrets
- Fully quit and restart Claude Desktop
{
"mcpServers": {
"mysql-legacy-mcp": {
"command": "npx",
"args": [
"-y",
"mysql-legacy-mcp"
],
"env": {
"MYSQL_LEGACY_HOST": "<MYSQL_LEGACY_HOST>",
"MYSQL_LEGACY_USER": "<MYSQL_LEGACY_USER>",
"MYSQL_LEGACY_PASSWORD": "<MYSQL_LEGACY_PASSWORD>"
}
}
}
}Trae — .trae/mcp.json (local)
- Trae → Settings → MCP, or edit .trae/mcp.json / global mcp.json
- Click Copy config and merge mcpServers
- Replace <placeholders> in env with real secrets
- Save and reload Trae
{
"mcpServers": {
"mysql-legacy-mcp": {
"command": "npx",
"args": [
"-y",
"mysql-legacy-mcp"
],
"env": {
"MYSQL_LEGACY_HOST": "<MYSQL_LEGACY_HOST>",
"MYSQL_LEGACY_USER": "<MYSQL_LEGACY_USER>",
"MYSQL_LEGACY_PASSWORD": "<MYSQL_LEGACY_PASSWORD>"
}
}
}
}Cherry Studio — MCP settings (local)
- Cherry Studio → Settings → MCP Servers → Add (STDIO)
- Or import JSON: click Copy config and merge mcpServers
- Replace <placeholders> in env; ensure Node.js / uv (npx, uvx) are installed
- Enable the server and check tools load
{
"mcpServers": {
"mysql-legacy-mcp": {
"command": "npx",
"args": [
"-y",
"mysql-legacy-mcp"
],
"env": {
"MYSQL_LEGACY_HOST": "<MYSQL_LEGACY_HOST>",
"MYSQL_LEGACY_USER": "<MYSQL_LEGACY_USER>",
"MYSQL_LEGACY_PASSWORD": "<MYSQL_LEGACY_PASSWORD>"
}
}
}
}Tongyi Lingma — MCP config (local)
- Lingma Settings → MCP → + → STDIO or config file
- Click Copy config and merge mcpServers
- Replace <placeholders> in env; need Node.js 18+ (npx) or uv (uvx)
- Confirm connected before using tools in agent chat
{
"mcpServers": {
"mysql-legacy-mcp": {
"command": "npx",
"args": [
"-y",
"mysql-legacy-mcp"
],
"env": {
"MYSQL_LEGACY_HOST": "<MYSQL_LEGACY_HOST>",
"MYSQL_LEGACY_USER": "<MYSQL_LEGACY_USER>",
"MYSQL_LEGACY_PASSWORD": "<MYSQL_LEGACY_PASSWORD>"
}
}
}
}Windsurf — mcp_config.json (local)
- Edit ~/.codeium/windsurf/mcp_config.json
- Click Copy config and merge mcpServers (stdio same as Cursor)
- Replace <placeholders> in env, save, refresh Cascade
{
"mcpServers": {
"mysql-legacy-mcp": {
"command": "npx",
"args": [
"-y",
"mysql-legacy-mcp"
],
"env": {
"MYSQL_LEGACY_HOST": "<MYSQL_LEGACY_HOST>",
"MYSQL_LEGACY_USER": "<MYSQL_LEGACY_USER>",
"MYSQL_LEGACY_PASSWORD": "<MYSQL_LEGACY_PASSWORD>"
}
}
}
}Cline — MCP Servers (local)
- Cline panel → Settings → MCP Servers
- Click Copy config and merge
- Replace <placeholders> in env, then save
{
"mcpServers": {
"mysql-legacy-mcp": {
"command": "npx",
"args": [
"-y",
"mysql-legacy-mcp"
],
"env": {
"MYSQL_LEGACY_HOST": "<MYSQL_LEGACY_HOST>",
"MYSQL_LEGACY_USER": "<MYSQL_LEGACY_USER>",
"MYSQL_LEGACY_PASSWORD": "<MYSQL_LEGACY_PASSWORD>"
}
}
}
}WorkBuddy — .workbuddy/mcp.json (local)
- Edit ~/.workbuddy/mcp.json (user) or project .workbuddy/mcp.json
- Or Plugins → MCP Servers → Configure MCP and paste the JSON below
- Replace <placeholders> in env; on Windows prefer absolute paths for command/scripts
- Save, restart WorkBuddy, confirm connector status is green
{
"mcpServers": {
"mysql-legacy-mcp": {
"command": "npx",
"args": [
"-y",
"mysql-legacy-mcp"
],
"env": {
"MYSQL_LEGACY_HOST": "<MYSQL_LEGACY_HOST>",
"MYSQL_LEGACY_USER": "<MYSQL_LEGACY_USER>",
"MYSQL_LEGACY_PASSWORD": "<MYSQL_LEGACY_PASSWORD>"
}
}
}
}Troubleshooting & Common ErrorsFAQ
Common connection errors and verified fixes for MySQL Legacy MCP
Getting 'connection closed' or exit code 1 in Cursor / Claude Code for MySQL Legacy MCP?
Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.
# Check binary path in terminal: which npx node -v
Getting 'spawn npx ENOENT' or 'command not found'?
The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).
Missing required environment variable or authentication failure?
MySQL Legacy MCP requires environment variables (MYSQL_LEGACY_HOST、MYSQL_LEGACY_USER、MYSQL_LEGACY_PASSWORD). Ensure you have added valid keys under the 'env' object in your config file without trailing whitespace.
// .cursor/mcp.json 或 claude_desktop_config.json
{
"env": {
"MYSQL_LEGACY_HOST": "your_actual_key_here"
}
}Tool Mock Playground
SandboxMySQL Legacy MCP Database Query Simulator · Preview tool schema & outputs without local runtime
{
"query": "SELECT id, name, status, created_at FROM records WHERE status = 'active' LIMIT 3;"
}Click 'Run Mock' above
to preview the raw response returned to the LLM
Decision Guide: Why & When to Use
Assess suitability before installing to save trial-and-error time
- Dev data exploration
- Read-only analytics SQL
- Schema documentation
- Unrestricted writes on production
- Exposing raw PII to AI
Postgres MCP + SQL skill → conversational BI
MCP hands-on: install to visible results
Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.
Related resources
OnlyFins Trout Talk
v1.4.0
stream.onlyfins/trout-talk
Live Utah trout cam: guess which wild trout swam into frame, named by spot patterns. Leaderboard.
locaihost data
v1.15.0
org.locaihost/data
Jobs, visa sponsors, tenders, SEC filings, KYB checks, company and domain intel via Apify.
webdata-tools-mcp
v0.14.0
io.github.tacps126/webdata-tools-mcp
38 web-data tools for AI agents: jobs, news, tenders, laws, markets, auctions, leads.
Magic Cloud
v24.4.7
io.github.polterguy/magic
Generate secured CRUD APIs over your database, run SQL, manage files, tasks and a headless browser
MCP for Adobe Premiere Pro
v1.28.0
io.github.leancoderkavy/premiere-pro
Local-first MCP for supported Adobe Premiere Pro workflows; start with a read-only connection check.
mcp-audit
v3.0.0
io.github.saagpatel/mcp-audit
Scan, enumerate, and risk-score every MCP server configured on your machine.
Often paired with
中文公文写作
v2.0.46
io.clawhub.gongyu0918-debug/chinese-official-writing
用于中文公文、事务性材料和新闻稿件的起草、改写、压缩、润色、审校、文种核对、去口语化、降 AI 味及 Word 格式处理,适用于机关、企事业单位、学校和新闻机构。涵盖申请、请示、报告、通知、通告、意见、决定、决议、议案、公报、命令、函、复函、批复、说明、方案、纪要、公告、公示、通报、制度、规定、办法、细则、操作规程、工作要点、总结、调研、讲话、致辞、主持词、述职、可研、审查材料、技术需求、新闻消息、编者按、新闻评论,以及采购、整改、反馈和 AI 算力等场景。
ShieldCortex
v5.15.3
io.clawhub.jarvis-drakon/shieldcortex
Memory and defence for AI agents: semantic recall, knowledge graph and decay, plus a memory firewall that scans and enforces against prompt injection, credential leaks and poisoning.
Network-AI
v5.17.1
io.clawhub.jovancoding/network-ai
Local Python orchestration skill: multi-agent workflows via shared blackboard file, permission gating, token budget scripts, and persistent project context. The bundled Python scripts make no network calls and have zero third-party dependencies. The parent repository also contains a TypeScript engine (not included in this skill bundle).
GitLab Agent Self Improvement
v1.122.2
io.clawhub.xrowgmbh/xrowgmbh-self-improvement
A skill for personal growth and self-improvement.
Keep exploring AgentHub
Most people compare similar tools or check scenario guides before installing—start here.
Listing badge: put AgentHub on your site
Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.
<a href="https://myagenthub.cn/p/io.github.Rufflet/mysql-legacy-mcp" title="Listed on AgentHub: MySQL Legacy MCP" target="_blank" rel="noopener">
<img src="https://myagenthub.cn/badge/io.github.Rufflet/mysql-legacy-mcp?lang=en" alt="Listed on AgentHub: MySQL Legacy MCP" height="20" style="border:0"/>
</a>[](https://myagenthub.cn/p/io.github.Rufflet/mysql-legacy-mcp)Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.
Unified Manifest
{
"id": "io.github.Rufflet/mysql-legacy-mcp",
"type": "mcp-server",
"version": "0.2.1",
"displayName": "MySQL Legacy MCP",
"description": "Inspect and query MySQL 5.0–5.6; opt-in INSERT/UPDATE/DELETE/DDL. Live-verified 5.0–8.0.",
"repository": {
"url": "https://github.com/Rufflet/mysql-legacy-mcp",
"source": "github"
},
"homepage": "https://github.com/Rufflet/mysql-legacy-mcp",
"distribution": {
"packages": [
{
"registryType": "npm",
"identifier": "mysql-legacy-mcp",
"version": "0.2.1",
"transport": "stdio",
"environmentVariables": [
{
"name": "MYSQL_LEGACY_HOST",
"description": "Database host or local tunnel endpoint",
"isRequired": true
},
{
"name": "MYSQL_LEGACY_USER",
"description": "Dedicated database reader account",
"isRequired": true
},
{
"name": "MYSQL_LEGACY_PASSWORD",
"description": "Nonempty database account password",
"isRequired": true,
"isSecret": true
},
{
"name": "MYSQL_LEGACY_PORT",
"description": "TCP port, 1–65535"
},
{
"name": "MYSQL_LEGACY_DATABASE",
"description": "Optional default database"
},
{
"name": "MYSQL_LEGACY_HIDE_SYSTEM_DATABASES",
"description": "Hide mysql and information_schema from listings"
},
{
"name": "MYSQL_LEGACY_QUERY_TIMEOUT",
"description": "Driver query timeout, 100–60000 milliseconds"
},
{
"name": "MYSQL_LEGACY_MAX_ROWS",
"description": "SELECT response row limit, 1–1000"
},
{
"name": "MYSQL_LEGACY_MAX_RESULT_BYTES",
"description": "SELECT row-data JSON byte limit, 1024–1048576"
},
{
"name": "MYSQL_LEGACY_CONNECT_TIMEOUT",
"description": "Connection-establishment timeout, 100–60000 milliseconds"
},
{
"name": "MYSQL_LEGACY_POOL_SIZE",
"description": "Pooled connection limit, 1–50"
},
{
"name": "MYSQL_LEGACY_ALLOW_INSERT",
"description": "Enable the mysql_legacy_insert tool"
},
{
"name": "MYSQL_LEGACY_ALLOW_UPDATE",
"description": "Enable the mysql_legacy_update tool (WHERE clause always required)"
},
{
"name": "MYSQL_LEGACY_ALLOW_DELETE",
"description": "Enable the mysql_legacy_delete tool (WHERE clause always required)"
},
{
"name": "MYSQL_LEGACY_ALLOW_DDL",
"description": "Enable the mysql_legacy_ddl tool (table-level statements only)"
},
{
"name": "MYSQL_LEGACY_DISABLE_READ_ONLY_TRANSACTIONS",
"description": "Disable the read-only transaction wrap around mysql_legacy_select on MySQL 5.6.5+"
}
]
}
],
"remotes": []
},
"dependencies": [],
"installTargets": [
"claude-code",
"claude-desktop",
"cursor",
"vscode",
"trae",
"cherry-studio",
"lingma",
"windsurf",
"cline",
"workbuddy"
],
"keywords": [],
"provenance": {
"origin": "official-mcp-registry",
"originalId": "io.github.Rufflet/mysql-legacy-mcp",
"originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Rufflet%2Fmysql-legacy-mcp/versions/latest",
"isOfficial": true,
"status": "active"
}
}