{"id":50742677,"url":"https://github.com/mergisi/ai2sql-mcp","last_synced_at":"2026-06-10T18:01:36.082Z","repository":{"id":362139443,"uuid":"1257628496","full_name":"mergisi/ai2sql-mcp","owner":"mergisi","description":"AI2SQL MCP Server - Generate, explain, optimize and fix SQL queries from natural language inside Claude Code. Supports PostgreSQL, MySQL, SQL Server, Snowflake, Oracle, SQLite.","archived":false,"fork":false,"pushed_at":"2026-06-02T21:32:13.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T22:06:22.230Z","etag":null,"topics":["ai2sql","claude","claude-code","database","developer-tools","mcp","mysql","postgresql","sql","text-to-sql"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mergisi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-02T21:27:59.000Z","updated_at":"2026-06-02T21:33:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mergisi/ai2sql-mcp","commit_stats":null,"previous_names":["mergisi/ai2sql-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/mergisi/ai2sql-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mergisi%2Fai2sql-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mergisi%2Fai2sql-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mergisi%2Fai2sql-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mergisi%2Fai2sql-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mergisi","download_url":"https://codeload.github.com/mergisi/ai2sql-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mergisi%2Fai2sql-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34163252,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai2sql","claude","claude-code","database","developer-tools","mcp","mysql","postgresql","sql","text-to-sql"],"created_at":"2026-06-10T18:01:35.220Z","updated_at":"2026-06-10T18:01:36.053Z","avatar_url":"https://github.com/mergisi.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003e🤖 AI2SQL MCP Server\u003c/h1\u003e\n  \u003cp\u003e\u003cstrong\u003eWrite SQL 10× faster — inside Claude Code\u003c/strong\u003e\u003c/p\u003e\n  \u003cp\u003eGenerate, explain, optimize, and fix SQL queries from natural language.\u003cbr\u003eSupports PostgreSQL, MySQL, SQL Server, Snowflake, Oracle \u0026 SQLite.\u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://www.npmjs.com/package/ai2sql-mcp\"\u003e\n      \u003cimg src=\"https://img.shields.io/npm/v/ai2sql-mcp?style=flat-square\u0026label=npm\" alt=\"npm version\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.npmjs.com/package/ai2sql-mcp\"\u003e\n      \u003cimg src=\"https://img.shields.io/npm/dm/ai2sql-mcp?style=flat-square\" alt=\"npm downloads\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/mergisi/ai2sql-mcp/blob/main/LICENSE\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/license/mergisi/ai2sql-mcp?style=flat-square\" alt=\"MIT license\"\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n## ✨ What is this?\n\n**AI2SQL MCP** turns plain English into SQL — right inside your Claude Code terminal. No tab-switching, no Stack Overflow, no \"WHERE clause syntax\" rabbit holes.\n\n```bash\n# Instead of writing this yourself:\nSELECT u.name, COUNT(o.id) as order_count, SUM(o.total) as revenue\nFROM users u\nJOIN orders o ON u.id = o.user_id\nWHERE o.created_at \u003e= NOW() - INTERVAL '30 days'\n  AND u.status = 'active'\nGROUP BY u.name\nHAVING SUM(o.total) \u003e 1000\nORDER BY revenue DESC\nLIMIT 10;\n\n# You just type: \"Show me active users who spent \u003e$1000 in the last 30 days\"\n# AI2SQL generates the query. You run it.\n```\n\n---\n\n## 🚀 Quick Start (30 seconds)\n\nAdd this to your `~/.cursor/mcp.json` or Claude Code settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"ai2sql\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"ai2sql-mcp\"]\n    }\n  }\n}\n```\n\nThat's it. Restart Claude Code and you're ready.\n\n---\n\n## 🛠️ Tools\n\n### `generate_sql` — Text → SQL\n```markdown\n\u003e Generate a query to find top 10 customers by revenue last month\n→ AI2SQL generates the perfect SQL with correct joins, aggregations, and filters\n```\n\n### `explain_sql` — What does this query do?\n```markdown\n\u003e Explain this query: SELECT ... (pastes complex SQL)\n→ \"This query joins the users and orders tables, filters for last quarter...\"\n```\n\n### `optimize_sql` — Make it faster\n```markdown\n\u003e Optimize this query for PostgreSQL: SELECT * FROM orders WHERE ...\n→ \"Added index hints, rewrote subquery as JOIN, removed unnecessary columns\"\n```\n\n### `fix_sql_error` — Debug mode\n```markdown\n\u003e Fix this query: SELECT ... (broken SQL)\n\u003e Error: column \"status\" does not exist\n→ \"Added missing column reference, fixed the GROUP BY clause\"\n```\n\n### `list_schemas` — Know your database (Pro)\n```markdown\n\u003e Show me my database schemas\n→ Returns all your saved tables, columns, and types from AI2SQL\n```\n\n---\n\n## 🔑 Pro Features\n\nGet unlimited queries and schema-aware generation with an API key:\n\n```json\n{\n  \"mcpServers\": {\n    \"ai2sql\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"ai2sql-mcp\"],\n      \"env\": {\n        \"AI2SQL_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n**How to get your API key:**\n1. Sign up at [ai2sql.io](https://ai2sql.io)\n2. Go to **Dashboard → API Keys**\n3. Click **Generate New Key**\n4. Copy and add to your config above\n\nWithout an API key you get **5 free queries per session** — enough to try it out.\n\n---\n\n## 🗄️ Supported Databases\n\n| Database | Dialect Name |\n|----------|-------------|\n| PostgreSQL | `postgres` |\n| MySQL | `mysql` |\n| SQL Server | `sqlserver` |\n| Snowflake | `snowflake` |\n| Oracle | `oracle` |\n| SQLite | `sqlite` |\n\n---\n\n## 💡 Use Cases\n\n- **Data analysts** — Stop writing JOINs from memory. Describe what you need.\n- **Backend developers** — Debug SQL errors without Googling error messages.\n- **Database migrations** — Generate ALTER TABLE, CREATE INDEX queries in seconds.\n- **Learning SQL** — See how natural language translates to real SQL queries.\n- **Team onboarding** — New devs can query production databases immediately.\n\n---\n\n## 💻 Works With\n\n| Platform | Setup |\n|----------|-------|\n| **Claude Code** | Add MCP config (see Quick Start) |\n| **Cursor IDE** | Add to `~/.cursor/mcp.json` |\n| **Windsurf** | Add to MCP settings |\n| **Continue.dev** | Add to config.json |\n| **Any MCP client** | Use `npx -y ai2sql-mcp` |\n\n---\n\n## 📦 Installation (alternative)\n\n```bash\n# Run directly without installing\nnpx -y ai2sql-mcp\n\n# Or install globally\nnpm install -g ai2sql-mcp\nai2sql-mcp\n```\n\n---\n\n## 🏗️ Architecture\n\n```\n┌─────────────────┐     ┌─────────────────┐     ┌──────────────┐\n│  Claude Code     │◄───►│  ai2sql-mcp     │◄───►│  AI2SQL API  │\n│  (MCP client)    │     │  (MCP server)   │     │  (cloud)     │\n└─────────────────┘     └─────────────────┘     └──────────────┘\n                                                       │\n                                               ┌───────┴───────┐\n                                               │  SQL Generator │\n                                               │  AI Engine     │\n                                               └───────────────┘\n```\n\n---\n\n## 📝 Changelog\n\nSee [releases](https://github.com/mergisi/ai2sql-mcp/releases).\n\n---\n\n## 🤝 Contributing\n\nPRs welcome! Check the [issues](https://github.com/mergisi/ai2sql-mcp/issues) for feature requests and bugs.\n\n---\n\n## 📄 License\n\nMIT © [Mustafa Ergisi](https://ai2sql.io)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://ai2sql.io\"\u003e🌐 Website\u003c/a\u003e ·\n    \u003ca href=\"https://github.com/mergisi/ai2sql-mcp\"\u003e📦 GitHub\u003c/a\u003e ·\n    \u003ca href=\"https://www.npmjs.com/package/ai2sql-mcp\"\u003e📥 npm\u003c/a\u003e ·\n    \u003ca href=\"https://x.com/ergisimustafa\"\u003e🐦 Twitter\u003c/a\u003e\n  \u003c/p\u003e\n  \u003cp\u003e⭐ Star us on GitHub — it helps other developers discover this tool!\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmergisi%2Fai2sql-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmergisi%2Fai2sql-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmergisi%2Fai2sql-mcp/lists"}