[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-Anarkh-Lee--universal-db-mcp":3,"tool-Anarkh-Lee--universal-db-mcp":61},[4,18,26,36,44,52],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",141543,2,"2026-04-06T11:32:54",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107888,"2026-04-06T11:32:50",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":10,"last_commit_at":58,"category_tags":59,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,60],"视频",{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":74,"owner_company":74,"owner_location":74,"owner_email":74,"owner_twitter":74,"owner_website":74,"owner_url":76,"languages":77,"stars":94,"forks":95,"last_commit_at":96,"license":97,"difficulty_score":32,"env_os":98,"env_gpu":99,"env_ram":99,"env_deps":100,"category_tags":105,"github_topics":74,"view_count":32,"oss_zip_url":74,"oss_zip_packed_at":74,"status":17,"created_at":107,"updated_at":108,"faqs":109,"releases":145},4504,"Anarkh-Lee\u002Funiversal-db-mcp","universal-db-mcp","通用数据库 MCP 连接器：支持 MySQL、PostgreSQL、Oracle、MongoDB 等 17 种数据库，支持 Claude Desktop、Cursor、Windsurf、VS Code、ChatGPT 等 50+ 平台，用自然语言查询和分析数据","universal-db-mcp 是一款基于模型上下文协议（MCP）构建的通用数据库连接工具，旨在让 AI 助手能够直接通过自然语言查询和分析您的数据库。它成功解决了传统数据交互中必须编写复杂 SQL 语句的痛点，让用户只需像日常对话一样提问（例如“展示本月订单额最高的前 10 位客户”），即可即时获取精准的数据洞察。\n\n这款工具非常适合开发者、数据分析师以及希望将 AI 能力融入工作流的普通用户。无论是使用 Claude Desktop、Cursor、VS Code 还是 ChatGPT 等超过 50 种主流平台，都能无缝接入。其核心优势在于广泛的兼容性，支持 MySQL、PostgreSQL、Oracle、MongoDB 等 17 种国内外常见数据库。\n\n在技术特性上，universal-db-mcp 展现了卓越的性能与安全性。它默认开启只读模式以防止误操作，并具备智能敏感数据脱敏功能，自动保护手机号、身份证等隐私信息。针对大型数据库，它引入了架构缓存和批量查询优化技术，将数百张表的元数据检索速度提升了高达 100 倍。此外，它还支持自动推断表间关系和多模式启动架构，确保了在高并发","universal-db-mcp 是一款基于模型上下文协议（MCP）构建的通用数据库连接工具，旨在让 AI 助手能够直接通过自然语言查询和分析您的数据库。它成功解决了传统数据交互中必须编写复杂 SQL 语句的痛点，让用户只需像日常对话一样提问（例如“展示本月订单额最高的前 10 位客户”），即可即时获取精准的数据洞察。\n\n这款工具非常适合开发者、数据分析师以及希望将 AI 能力融入工作流的普通用户。无论是使用 Claude Desktop、Cursor、VS Code 还是 ChatGPT 等超过 50 种主流平台，都能无缝接入。其核心优势在于广泛的兼容性，支持 MySQL、PostgreSQL、Oracle、MongoDB 等 17 种国内外常见数据库。\n\n在技术特性上，universal-db-mcp 展现了卓越的性能与安全性。它默认开启只读模式以防止误操作，并具备智能敏感数据脱敏功能，自动保护手机号、身份证等隐私信息。针对大型数据库，它引入了架构缓存和批量查询优化技术，将数百张表的元数据检索速度提升了高达 100 倍。此外，它还支持自动推断表间关系和多模式启动架构，确保了在高并发场景下的稳定与高效，是连接人工智能与企业数据的理想桥梁。","\u003Cp align=\"center\">\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FAnarkh-Lee_universal-db-mcp_readme_a27bbf346ffa.png\" alt=\"Universal DB MCP Logo\" width=\"200\">\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">Universal DB MCP\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n \u003Cstrong>Connect AI to Your Database with Natural Language\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n A universal database connector implementing the Model Context Protocol (MCP) and HTTP API, enabling AI assistants to query and analyze your databases using natural language. Works with Claude Desktop, Cursor, Windsurf, VS Code, ChatGPT, and 50+ other platforms.\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Funiversal-db-mcp\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Funiversal-db-mcp.svg?style=flat-square&color=blue\" alt=\"npm version\">\u003C\u002Fa>\n \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Funiversal-db-mcp\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Funiversal-db-mcp.svg?style=flat-square&color=green\" alt=\"npm downloads\">\u003C\u002Fa>\n \u003Ca href=\"https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg?style=flat-square\" alt=\"License: MIT\">\u003C\u002Fa>\n \u003Ca href=\"https:\u002F\u002Fnodejs.org\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D20.0.0-brightgreen?style=flat-square\" alt=\"Node.js Version\">\u003C\u002Fa>\n \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\u002Funiversal-db-mcp\u002Fstargazers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FAnarkh-Lee\u002Funiversal-db-mcp?style=flat-square\" alt=\"GitHub Stars\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n \u003Ca href=\"#-features\">Features\u003C\u002Fa> •\n \u003Ca href=\"#-quick-start\">Quick Start\u003C\u002Fa> •\n \u003Ca href=\"#-supported-databases\">Databases\u003C\u002Fa> •\n \u003Ca href=\"#-documentation\">Docs\u003C\u002Fa> •\n \u003Ca href=\"#-contributing\">Contributing\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n \u003Ca href=\".\u002FREADME.md\">English\u003C\u002Fa> | \u003Ca href=\".\u002FREADME.zh-CN.md\">中文文档\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\n## Why Universal DB MCP?\n\nImagine asking your AI assistant: *\"Show me the top 10 customers by order value this month\"* and getting instant results from your database - no SQL writing required. Universal DB MCP makes this possible by bridging AI assistants with your databases through the Model Context Protocol (MCP) and HTTP API.\n\n```\nYou: \"What's the average order value for users who signed up in the last 30 days?\"\n\nAI: Let me query that for you...\n\n┌─────────────────────────────────────┐\n│ Average Order Value: $127.45 │\n│ Total New Users: 1,247 │\n│ Users with Orders: 892 (71.5%) │\n└─────────────────────────────────────┘\n```\n\n## ✨ Features\n\n- **17 Database Support** - MySQL, PostgreSQL, Redis, Oracle, SQL Server, MongoDB, SQLite, and 10 Chinese domestic databases\n- **55+ Platform Integrations** - Works with Claude Desktop, Cursor, VS Code, ChatGPT, Dify, and [50+ other platforms](#-supported-platforms)\n- **Flexible Architecture** - 2 startup modes (stdio\u002Fhttp) with 4 access methods: MCP stdio, MCP SSE, MCP Streamable HTTP, and REST API\n- **Security First** - Read-only mode by default prevents accidental data modifications\n- **Intelligent Caching** - Schema caching with configurable TTL for blazing-fast performance\n- **Batch Query Optimization** - Up to 100x faster schema retrieval for large databases\n- **Schema Enhancement** - Table comments, implicit relationship inference for better Text2SQL accuracy\n- **Multi-Schema Support** - Automatic discovery of all user schemas (PostgreSQL, SQL Server, Oracle, DM, and more)\n- **Data Masking** - Automatic sensitive data protection (phone, email, ID card, bank card, etc.)\n- **Connection Stability** - Connection pooling, TCP Keep-Alive, and automatic reconnection for long-running sessions\n\n### Performance Improvements\n\n| Tables | Before | After | Improvement |\n|--------|--------|-------|-------------|\n| 50 tables | ~5s | ~200ms | **25x faster** |\n| 100 tables | ~10s | ~300ms | **33x faster** |\n| 500 tables | ~50s | ~500ms | **100x faster** |\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\nnpm install -g universal-db-mcp\n```\n\n### MCP Mode (Claude Desktop)\n\nAdd to your Claude Desktop configuration file:\n\n- **macOS**: `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"my-database\": {\n \"command\": \"npx\",\n \"args\": [\n \"universal-db-mcp\",\n \"--type\", \"mysql\",\n \"--host\", \"localhost\",\n \"--port\", \"3306\",\n \"--user\", \"root\",\n \"--password\", \"your_password\",\n \"--database\", \"your_database\"\n ]\n }\n }\n}\n```\n\nRestart Claude Desktop and start asking questions:\n\n- *\"Show me the structure of the users table\"*\n- *\"Count orders from the last 7 days\"*\n- *\"Find the top 5 products by sales\"*\n\n### HTTP API Mode\n\n```bash\n# Set environment variables\nexport MODE=http\nexport HTTP_PORT=3000\nexport API_KEYS=your-secret-key\n\n# Start the server\nnpx universal-db-mcp\n```\n\n```bash\n# Test the API\ncurl http:\u002F\u002Flocalhost:3000\u002Fapi\u002Fhealth\n```\n\n### MCP SSE Mode (Dify and Remote Access)\n\nWhen running in HTTP mode, the server also exposes MCP protocol endpoints via SSE (Server-Sent Events) and Streamable HTTP. This allows platforms like Dify to connect using the MCP protocol directly.\n\n**SSE Endpoint (Legacy):**\n```\nGET http:\u002F\u002Flocalhost:3000\u002Fsse?type=mysql&host=localhost&port=3306&user=root&password=xxx&database=mydb\n```\n\n**Streamable HTTP Endpoint (MCP 2025 Spec, Recommended):**\n```\nPOST http:\u002F\u002Flocalhost:3000\u002Fmcp\nHeaders:\n X-DB-Type: mysql\n X-DB-Host: localhost\n X-DB-Port: 3306\n X-DB-User: root\n X-DB-Password: your_password\n X-DB-Database: your_database\nBody: MCP JSON-RPC request\n```\n\n| Endpoint | Method | Description |\n|----------|--------|-------------|\n| `\u002Fsse` | GET | Establish SSE connection (legacy) |\n| `\u002Fsse\u002Fmessage` | POST | Send message to SSE session |\n| `\u002Fmcp` | POST | Streamable HTTP endpoint (recommended) |\n| `\u002Fmcp` | GET | SSE stream for Streamable HTTP |\n| `\u002Fmcp` | DELETE | Close session |\n\nSee [Dify Integration Guide](.\u002Fdocs\u002Fintegrations\u002FDIFY.md) for detailed setup instructions.\n\n## 📊 Supported Databases\n\n| Database | Type | Default Port | Category |\n|----------|------|--------------|----------|\n| MySQL | `mysql` | 3306 | Open Source |\n| PostgreSQL | `postgres` | 5432 | Open Source |\n| Redis | `redis` | 6379 | NoSQL |\n| Oracle | `oracle` | 1521 | Commercial |\n| SQL Server | `sqlserver` | 1433 | Commercial |\n| MongoDB | `mongodb` | 27017 | NoSQL |\n| SQLite | `sqlite` | - | Embedded |\n| Dameng (达梦) | `dm` | 5236 | Chinese |\n| KingbaseES | `kingbase` | 54321 | Chinese |\n| GaussDB | `gaussdb` | 5432 | Chinese (Huawei) |\n| OceanBase | `oceanbase` | 2881 | Chinese (Ant) |\n| TiDB | `tidb` | 4000 | Distributed |\n| ClickHouse | `clickhouse` | 8123 | OLAP |\n| PolarDB | `polardb` | 3306 | Cloud (Alibaba) |\n| Vastbase | `vastbase` | 5432 | Chinese |\n| HighGo | `highgo` | 5866 | Chinese |\n| GoldenDB | `goldendb` | 3306 | Chinese (ZTE) |\n\n## 🏗️ Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│ Universal DB MCP │\n├─────────────────────────────────────────────────────────────────────────┤\n│ │\n│ Startup Modes: │\n│ ┌────────────────────────────┬────────────────────────────────────┐ │\n│ │ stdio mode │ http mode │ │\n│ │ (npm run start:mcp) │ (npm run start:http) │ │\n│ └─────────────┬──────────────┴───────────────┬────────────────────┘ │\n│ │ │ │\n│ ▼ ▼ │\n│ ┌─────────────────────────┐ ┌───────────────────────────────────┐ │\n│ │ MCP Protocol │ │ HTTP Server │ │\n│ │ (stdio transport) │ │ │ │\n│ │ │ │ ┌─────────────────────────────┐ │ │\n│ │ Tools: │ │ │ MCP Protocol │ │ │\n│ │ • execute_query │ │ │ (SSE \u002F Streamable HTTP) │ │ │\n│ │ • get_schema │ │ │ │ │ │\n│ │ • get_table_info │ │ │ Tools: (same as stdio) │ │ │\n│ │ • clear_cache │ │ │ • execute_query │ │ │\n│ │ • get_enum_values │ │ │ • get_schema │ │ │\n│ │ • get_sample_data │ │ │ • get_table_info │ │ │\n│ │ • connect_database │ │ │ • clear_cache │ │ │\n│ │ • disconnect_database │ │ │ • get_enum_values │ │ │\n│ │ • get_connection_status│ │ │ • get_sample_data │ │ │\n│ │ │ │ │ • connect_database │ │ │\n│ │ For: Claude Desktop, │ │ │ • disconnect_database │ │ │\n│ │ Cursor, etc. │ │ │ • get_connection_status │ │ │\n│ └─────────────┬───────────┘ │ │ │ │ │\n│ │ │ │ For: Dify, Remote Access │ │ │\n│ │ │ └──────────────┬──────────────┘ │ │\n│ │ │ │ │ │\n│ │ │ ┌──────────────┴──────────────┐ │ │\n│ │ │ │ REST API │ │ │\n│ │ │ │ │ │ │\n│ │ │ │ Endpoints: │ │ │\n│ │ │ │ • \u002Fapi\u002Fconnect │ │ │\n│ │ │ │ • \u002Fapi\u002Fquery │ │ │\n│ │ │ │ • \u002Fapi\u002Fschema │ │ │\n│ │ │ │ • ... (10+ endpoints) │ │ │\n│ │ │ │ │ │ │\n│ │ │ │ For: Coze, n8n, Custom │ │ │\n│ │ │ └──────────────┬──────────────┘ │ │\n│ │ └─────────────────┼─────────────────┘ │\n│ │ │ │\n│ └──────────────────┬───────────────┘ │\n│ ▼ │\n│ ┌──────────────────────────────────────────────────────────────────┐ │\n│ │ Core Business Logic │ │\n│ │ • Query Execution • Schema Caching │ │\n│ │ • Safety Validation • Connection Management │ │\n│ └──────────────────────────────────┬───────────────────────────────┘ │\n│ ▼ │\n│ ┌──────────────────────────────────────────────────────────────────┐ │\n│ │ Database Adapter Layer │ │\n│ │ MySQL │ PostgreSQL │ Redis │ Oracle │ MongoDB │ SQLite │ ... │ │\n│ │ (Connection Pool + TCP Keep-Alive + Auto-Retry) │ │\n│ └──────────────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\n## 🔒 Security\n\nBy default, Universal DB MCP runs in **read-only mode**, blocking all write operations (INSERT, UPDATE, DELETE, DROP, etc.).\n\n### Permission Modes\n\nFine-grained permission control is supported for flexible configuration:\n\n| Mode | Allowed Operations | Description |\n|------|-------------------|-------------|\n| `safe` (default) | SELECT | Read-only, safest |\n| `readwrite` | SELECT, INSERT, UPDATE | Read\u002Fwrite but no delete |\n| `full` | All operations | Full control (dangerous!) |\n| `custom` | Custom combination | Specify via `--permissions` |\n\n**Permission Types:**\n- `read` - SELECT queries (always included)\n- `insert` - INSERT, REPLACE\n- `update` - UPDATE\n- `delete` - DELETE, TRUNCATE\n- `ddl` - CREATE, ALTER, DROP, RENAME\n\n**Usage Examples:**\n\n```bash\n# Read-only mode (default)\nnpx universal-db-mcp --type mysql ...\n\n# Read\u002Fwrite but no delete\nnpx universal-db-mcp --type mysql --permission-mode readwrite ...\n\n# Custom: only read and insert\nnpx universal-db-mcp --type mysql --permissions read,insert ...\n\n# Full control (equivalent to --danger-allow-write)\nnpx universal-db-mcp --type mysql --permission-mode full ...\n```\n\n**Permission Configuration by Transport:**\n\n> ⚠️ Different transports use different parameter naming conventions!\n\n| Transport | Parameter Location | Permission Mode | Custom Permissions |\n|-----------|-------------------|-----------------|-------------------|\n| STDIO (Claude Desktop) | CLI args | `--permission-mode` | `--permissions` |\n| SSE (Dify, etc.) | URL Query | `permissionMode` | `permissions` |\n| Streamable HTTP | HTTP Header | `X-DB-Permission-Mode` | `X-DB-Permissions` |\n| REST API | JSON Body | `permissionMode` | `permissions` |\n\n**Best Practices:**\n- Never enable write mode in production\n- Use dedicated read-only database accounts\n- Connect through VPN or bastion hosts\n- Regularly audit query logs\n\n## 🔌 Supported Platforms\n\nUniversal DB MCP works with any platform that supports the MCP protocol or REST API. Here's a comprehensive list:\n\n### AI-Powered Code Editors & IDEs\n\n| Platform | Access Method | Description | Guide |\n|----------|---------------|-------------|-------|\n| [Cursor](https:\u002F\u002Fcursor.sh\u002F) | MCP stdio | AI-powered code editor with built-in MCP support | [EN](.\u002Fdocs\u002Fintegrations\u002FCURSOR.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCURSOR.zh-CN.md) |\n| [Windsurf](https:\u002F\u002Fcodeium.com\u002Fwindsurf) | MCP stdio | Codeium's AI IDE with Cascade agent | [EN](.\u002Fdocs\u002Fintegrations\u002FWINDSURF.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FWINDSURF.zh-CN.md) |\n| [VS Code](https:\u002F\u002Fcode.visualstudio.com\u002F) | MCP stdio \u002F REST API | Via GitHub Copilot agent mode or Cline\u002FContinue extensions | [EN](.\u002Fdocs\u002Fintegrations\u002FVSCODE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FVSCODE.zh-CN.md) |\n| [Zed](https:\u002F\u002Fzed.dev\u002F) | MCP stdio | High-performance open-source code editor | [EN](.\u002Fdocs\u002Fintegrations\u002FZED.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FZED.zh-CN.md) |\n| [IntelliJ IDEA](https:\u002F\u002Fwww.jetbrains.com\u002Fidea\u002F) | MCP stdio | JetBrains IDE with MCP support (2025.1+) | [EN](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.zh-CN.md) |\n| [PyCharm](https:\u002F\u002Fwww.jetbrains.com\u002Fpycharm\u002F) | MCP stdio | JetBrains Python IDE | [EN](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.zh-CN.md) |\n| [WebStorm](https:\u002F\u002Fwww.jetbrains.com\u002Fwebstorm\u002F) | MCP stdio | JetBrains JavaScript IDE | [EN](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.zh-CN.md) |\n| [Android Studio](https:\u002F\u002Fdeveloper.android.com\u002Fstudio) | MCP stdio | Via JetBrains MCP plugin | [EN](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.zh-CN.md) |\n| [Neovim](https:\u002F\u002Fneovim.io\u002F) | MCP stdio | Via MCPHub.nvim plugin | [EN](.\u002Fdocs\u002Fintegrations\u002FNEOVIM.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FNEOVIM.zh-CN.md) |\n| [Emacs](https:\u002F\u002Fwww.gnu.org\u002Fsoftware\u002Femacs\u002F) | MCP stdio | Via mcp.el package | [EN](.\u002Fdocs\u002Fintegrations\u002FEMACS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FEMACS.zh-CN.md) |\n\n### AI Coding Assistants\n\n| Platform | Access Method | Description | Guide |\n|----------|---------------|-------------|-------|\n| [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) | MCP stdio | Anthropic's agentic coding tool | [EN](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-CODE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-CODE.zh-CN.md) |\n| [GitHub Copilot](https:\u002F\u002Fgithub.com\u002Ffeatures\u002Fcopilot) | MCP stdio | Agent mode in VS Code\u002FJetBrains | [EN](.\u002Fdocs\u002Fintegrations\u002FGITHUB-COPILOT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FGITHUB-COPILOT.zh-CN.md) |\n| [Cline](https:\u002F\u002Fgithub.com\u002Fcline\u002Fcline) | MCP stdio \u002F REST API | Autonomous coding agent for VS Code | [EN](.\u002Fdocs\u002Fintegrations\u002FCLINE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCLINE.zh-CN.md) |\n| [Continue](https:\u002F\u002Fcontinue.dev\u002F) | MCP stdio | Open-source AI code assistant | [EN](.\u002Fdocs\u002Fintegrations\u002FCONTINUE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCONTINUE.zh-CN.md) |\n| [Roo Code](https:\u002F\u002Fgithub.com\u002Froovet\u002Froo-code) | MCP stdio | Fork of Cline for VS Code | [EN](.\u002Fdocs\u002Fintegrations\u002FROO-CODE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FROO-CODE.zh-CN.md) |\n| [Sourcegraph Cody](https:\u002F\u002Fsourcegraph.com\u002Fcody) | MCP stdio | AI coding assistant | [EN](.\u002Fdocs\u002Fintegrations\u002FSOURCEGRAPH-CODY.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FSOURCEGRAPH-CODY.zh-CN.md) |\n| [Amazon Q Developer](https:\u002F\u002Faws.amazon.com\u002Fq\u002Fdeveloper\u002F) | MCP stdio | AWS AI coding assistant | [EN](.\u002Fdocs\u002Fintegrations\u002FAMAZON-Q-DEVELOPER.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FAMAZON-Q-DEVELOPER.zh-CN.md) |\n| [Devin](https:\u002F\u002Fdevin.ai\u002F) | MCP stdio | AI software engineer | [EN](.\u002Fdocs\u002Fintegrations\u002FDEVIN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FDEVIN.zh-CN.md) |\n| [Goose](https:\u002F\u002Fgithub.com\u002Fblock\u002Fgoose) | MCP stdio | Block's AI coding agent | [EN](.\u002Fdocs\u002Fintegrations\u002FGOOSE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FGOOSE.zh-CN.md) |\n| [Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli) | MCP stdio | Google's command-line AI tool | [EN](.\u002Fdocs\u002Fintegrations\u002FGEMINI-CLI.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FGEMINI-CLI.zh-CN.md) |\n\n### Desktop AI Chat Applications\n\n| Platform | Access Method | Description | Guide |\n|----------|---------------|-------------|-------|\n| [Claude Desktop](https:\u002F\u002Fclaude.ai\u002Fdownload) | MCP stdio | Anthropic's official desktop app | [EN](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-DESKTOP.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-DESKTOP.zh-CN.md) |\n| [ChatGPT Desktop](https:\u002F\u002Fopenai.com\u002Fchatgpt\u002Fdesktop\u002F) | MCP SSE\u002FStreamable HTTP | OpenAI's desktop app with MCP connectors | [EN](.\u002Fdocs\u002Fintegrations\u002FCHATGPT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCHATGPT.zh-CN.md) |\n| [Cherry Studio](https:\u002F\u002Fgithub.com\u002Fkangfenmao\u002Fcherry-studio) | MCP stdio | Multi-model desktop chat app | [EN](.\u002Fdocs\u002Fintegrations\u002FCHERRY-STUDIO.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCHERRY-STUDIO.zh-CN.md) |\n| [LM Studio](https:\u002F\u002Flmstudio.ai\u002F) | MCP stdio | Run local LLMs with MCP support | [EN](.\u002Fdocs\u002Fintegrations\u002FLM-STUDIO.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FLM-STUDIO.zh-CN.md) |\n| [Jan](https:\u002F\u002Fjan.ai\u002F) | MCP stdio | Open-source ChatGPT alternative | [EN](.\u002Fdocs\u002Fintegrations\u002FJAN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJAN.zh-CN.md) |\n| [Msty](https:\u002F\u002Fmsty.app\u002F) | MCP stdio | Desktop AI chat application | [EN](.\u002Fdocs\u002Fintegrations\u002FMSTY.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FMSTY.zh-CN.md) |\n| [LibreChat](https:\u002F\u002Fgithub.com\u002Fdanny-avila\u002FLibreChat) | MCP stdio | Open-source chat interface | [EN](.\u002Fdocs\u002Fintegrations\u002FLIBRECHAT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FLIBRECHAT.zh-CN.md) |\n| [Witsy](https:\u002F\u002Fwitsy.app\u002F) | MCP stdio | Desktop AI assistant | [EN](.\u002Fdocs\u002Fintegrations\u002FWITSY.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FWITSY.zh-CN.md) |\n| [5ire](https:\u002F\u002Fgithub.com\u002F5ire-tech\u002F5ire) | MCP stdio | Cross-platform AI chat | [EN](.\u002Fdocs\u002Fintegrations\u002F5IRE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002F5IRE.zh-CN.md) |\n| [ChatMCP](https:\u002F\u002Fgithub.com\u002Fdaodao97\u002Fchatmcp) | MCP stdio | MCP-focused chat UI | [EN](.\u002Fdocs\u002Fintegrations\u002FCHATMCP.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCHATMCP.zh-CN.md) |\n| [HyperChat](https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat) | MCP stdio | Multi-platform chat app | [EN](.\u002Fdocs\u002Fintegrations\u002FHYPERCHAT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FHYPERCHAT.zh-CN.md) |\n| [Tome](https:\u002F\u002Fgithub.com\u002Frunebook\u002Ftome) | MCP stdio | macOS app for local LLMs | [EN](.\u002Fdocs\u002Fintegrations\u002FTOME.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FTOME.zh-CN.md) |\n\n### Web-Based AI Platforms\n\n| Platform | Access Method | Description | Guide |\n|----------|---------------|-------------|-------|\n| [Claude.ai](https:\u002F\u002Fclaude.ai\u002F) | MCP SSE\u002FStreamable HTTP | Anthropic's web interface | [EN](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-AI.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-AI.zh-CN.md) |\n| [ChatGPT](https:\u002F\u002Fchat.openai.com\u002F) | MCP SSE\u002FStreamable HTTP | Via custom connectors | [EN](.\u002Fdocs\u002Fintegrations\u002FCHATGPT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCHATGPT.zh-CN.md) |\n| [Dify](https:\u002F\u002Fdify.ai\u002F) | MCP SSE\u002FStreamable HTTP | LLM app development platform | [EN](.\u002Fdocs\u002Fintegrations\u002FDIFY.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FDIFY.zh-CN.md) |\n| [Coze](https:\u002F\u002Fwww.coze.com\u002F) | REST API | ByteDance's AI bot platform | [EN](.\u002Fdocs\u002Fintegrations\u002FCOZE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCOZE.zh-CN.md) |\n| [n8n](https:\u002F\u002Fn8n.io\u002F) | REST API \u002F MCP | Workflow automation platform | [EN](.\u002Fdocs\u002Fintegrations\u002FN8N.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FN8N.zh-CN.md) |\n| [Replit](https:\u002F\u002Freplit.com\u002F) | MCP stdio | Online IDE with AI agent | [EN](.\u002Fdocs\u002Fintegrations\u002FREPLIT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FREPLIT.zh-CN.md) |\n| [MindPal](https:\u002F\u002Fmindpal.io\u002F) | MCP SSE\u002FStreamable HTTP | No-code AI agent builder | [EN](.\u002Fdocs\u002Fintegrations\u002FMINDPAL.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FMINDPAL.zh-CN.md) |\n\n### Agent Frameworks & SDKs\n\n| Platform | Access Method | Description | Guide |\n|----------|---------------|-------------|-------|\n| [LangChain](https:\u002F\u002Flangchain.com\u002F) | MCP stdio | Popular LLM framework | [EN](.\u002Fdocs\u002Fintegrations\u002FLANGCHAIN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FLANGCHAIN.zh-CN.md) |\n| [Smolagents](https:\u002F\u002Fgithub.com\u002Fhuggingface\u002Fsmolagents) | MCP stdio | Hugging Face agent library | [EN](.\u002Fdocs\u002Fintegrations\u002FSMOLAGENTS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FSMOLAGENTS.zh-CN.md) |\n| [OpenAI Agents SDK](https:\u002F\u002Fplatform.openai.com\u002F) | MCP SSE\u002FStreamable HTTP | OpenAI's agent framework | [EN](.\u002Fdocs\u002Fintegrations\u002FOPENAI-AGENTS-SDK.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FOPENAI-AGENTS-SDK.zh-CN.md) |\n| [Amazon Bedrock Agents](https:\u002F\u002Faws.amazon.com\u002Fbedrock\u002F) | MCP SSE\u002FStreamable HTTP | AWS AI agent service | [EN](.\u002Fdocs\u002Fintegrations\u002FAMAZON-BEDROCK-AGENTS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FAMAZON-BEDROCK-AGENTS.zh-CN.md) |\n| [Google ADK](https:\u002F\u002Fcloud.google.com\u002F) | MCP stdio | Google's Agent Development Kit | [EN](.\u002Fdocs\u002Fintegrations\u002FGOOGLE-ADK.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FGOOGLE-ADK.zh-CN.md) |\n| [Vercel AI SDK](https:\u002F\u002Fsdk.vercel.ai\u002F) | MCP stdio | Vercel's AI development kit | [EN](.\u002Fdocs\u002Fintegrations\u002FVERCEL-AI-SDK.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FVERCEL-AI-SDK.zh-CN.md) |\n| [Spring AI](https:\u002F\u002Fspring.io\u002Fprojects\u002Fspring-ai) | MCP stdio | Java\u002FSpring AI framework | [EN](.\u002Fdocs\u002Fintegrations\u002FSPRING-AI.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FSPRING-AI.zh-CN.md) |\n\n### CLI Tools & Terminal\n\n| Platform | Access Method | Description | Guide |\n|----------|---------------|-------------|-------|\n| [Claude Code CLI](https:\u002F\u002Fclaude.ai\u002Fcode) | MCP stdio | Terminal-based coding agent | [EN](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-CODE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-CODE.zh-CN.md) |\n| [Warp](https:\u002F\u002Fwww.warp.dev\u002F) | MCP stdio | AI-powered terminal | [EN](.\u002Fdocs\u002Fintegrations\u002FWARP.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FWARP.zh-CN.md) |\n| [Oterm](https:\u002F\u002Fgithub.com\u002Fggozad\u002Foterm) | MCP stdio | Chat with Ollama via CLI | [EN](.\u002Fdocs\u002Fintegrations\u002FOTERM.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FOTERM.zh-CN.md) |\n| [MCPHost](https:\u002F\u002Fgithub.com\u002Fmark3labs\u002Fmcphost) | MCP stdio | CLI chat with LLMs | [EN](.\u002Fdocs\u002Fintegrations\u002FMCPHOST.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FMCPHOST.zh-CN.md) |\n\n### Productivity & Automation\n\n| Platform | Access Method | Description | Guide |\n|----------|---------------|-------------|-------|\n| [Raycast](https:\u002F\u002Fraycast.com\u002F) | MCP stdio | macOS productivity launcher | [EN](.\u002Fdocs\u002Fintegrations\u002FRAYCAST.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FRAYCAST.zh-CN.md) |\n| [Notion](https:\u002F\u002Fnotion.so\u002F) | MCP SSE\u002FStreamable HTTP | Workspace with AI integration | [EN](.\u002Fdocs\u002Fintegrations\u002FNOTION.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FNOTION.zh-CN.md) |\n| [Obsidian](https:\u002F\u002Fobsidian.md\u002F) | MCP stdio | Via MCP Tools plugin | [EN](.\u002Fdocs\u002Fintegrations\u002FOBSIDIAN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FOBSIDIAN.zh-CN.md) |\n| [Home Assistant](https:\u002F\u002Fwww.home-assistant.io\u002F) | MCP stdio | Home automation platform | [EN](.\u002Fdocs\u002Fintegrations\u002FHOME-ASSISTANT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FHOME-ASSISTANT.zh-CN.md) |\n\n### Messaging Platform Integrations\n\n| Platform | Access Method | Description | Guide |\n|----------|---------------|-------------|-------|\n| [Slack](https:\u002F\u002Fslack.com\u002F) | MCP stdio \u002F REST API | Via Slack MCP bots | [EN](.\u002Fdocs\u002Fintegrations\u002FSLACK.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FSLACK.zh-CN.md) |\n| [Discord](https:\u002F\u002Fdiscord.com\u002F) | MCP stdio \u002F REST API | Via Discord MCP bots | [EN](.\u002Fdocs\u002Fintegrations\u002FDISCORD.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FDISCORD.zh-CN.md) |\n| [Mattermost](https:\u002F\u002Fmattermost.com\u002F) | MCP stdio | Open-source messaging | [EN](.\u002Fdocs\u002Fintegrations\u002FMATTERMOST.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FMATTERMOST.zh-CN.md) |\n\n### Local LLM Runners\n\n| Platform | Access Method | Description | Guide |\n|----------|---------------|-------------|-------|\n| [Ollama](https:\u002F\u002Follama.ai\u002F) | MCP stdio | Run local LLMs | [EN](.\u002Fdocs\u002Fintegrations\u002FOLLAMA.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FOLLAMA.zh-CN.md) |\n| [LM Studio](https:\u002F\u002Flmstudio.ai\u002F) | MCP stdio | Local LLM desktop app | [EN](.\u002Fdocs\u002Fintegrations\u002FLM-STUDIO.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FLM-STUDIO.zh-CN.md) |\n| [Jan](https:\u002F\u002Fjan.ai\u002F) | MCP stdio | Offline ChatGPT alternative | [EN](.\u002Fdocs\u002Fintegrations\u002FJAN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJAN.zh-CN.md) |\n\n### Development & Testing Tools\n\n| Platform | Access Method | Description | Guide |\n|----------|---------------|-------------|-------|\n| [MCP Inspector](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Finspector) | MCP stdio | Official MCP debugging tool | [EN](.\u002Fdocs\u002Fintegrations\u002FMCP-INSPECTOR.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FMCP-INSPECTOR.zh-CN.md) |\n| [Postman](https:\u002F\u002Fpostman.com\u002F) | REST API \u002F MCP | API testing platform | [EN](.\u002Fdocs\u002Fintegrations\u002FPOSTMAN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FPOSTMAN.zh-CN.md) |\n\n> **Note**: Any MCP-compatible client can connect via stdio (local) or SSE\u002FStreamable HTTP (remote). Any HTTP client can use the REST API.\n\n## 📚 Documentation\n\n### Getting Started\n- [Installation Guide](.\u002Fdocs\u002Fgetting-started\u002Finstallation.md)\n- [Quick Start](.\u002Fdocs\u002Fgetting-started\u002Fquick-start.md)\n- [Configuration](.\u002Fdocs\u002Fgetting-started\u002Fconfiguration.md)\n- [Usage Examples](.\u002Fdocs\u002Fgetting-started\u002Fexamples.md)\n\n### Deployment\n- [Deployment Overview](.\u002Fdocs\u002Fdeployment\u002FREADME.md)\n- [Local Deployment](.\u002Fdocs\u002Fdeployment\u002Flocal.md)\n- [Docker Deployment](.\u002Fdocs\u002Fdeployment\u002Fdocker.md)\n- [Cloud Deployment](.\u002Fdocs\u002Fdeployment\u002Fcloud\u002F)\n\n### Database Guides\n- [Database Support Overview](.\u002Fdocs\u002Fdatabases\u002FREADME.md)\n- [MySQL](.\u002Fdocs\u002Fdatabases\u002Fmysql.md)\n- [PostgreSQL](.\u002Fdocs\u002Fdatabases\u002Fpostgresql.md)\n- [More databases...](.\u002Fdocs\u002Fdatabases\u002F)\n\n### HTTP API\n- [API Reference](.\u002Fdocs\u002Fhttp-api\u002FAPI_REFERENCE.md)\n- [Deployment Guide](.\u002Fdocs\u002Fhttp-api\u002FDEPLOYMENT.md)\n\n### Integrations\n\n**AI Editors & IDEs:**\n[Cursor](.\u002Fdocs\u002Fintegrations\u002FCURSOR.md) |\n[VS Code](.\u002Fdocs\u002Fintegrations\u002FVSCODE.md) |\n[JetBrains](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.md) |\n[Windsurf](.\u002Fdocs\u002Fintegrations\u002FWINDSURF.md) |\n[Zed](.\u002Fdocs\u002Fintegrations\u002FZED.md) |\n[Neovim](.\u002Fdocs\u002Fintegrations\u002FNEOVIM.md) |\n[Emacs](.\u002Fdocs\u002Fintegrations\u002FEMACS.md)\n\n**AI Assistants:**\n[Claude Desktop](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-DESKTOP.md) |\n[Claude Code](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-CODE.md) |\n[GitHub Copilot](.\u002Fdocs\u002Fintegrations\u002FGITHUB-COPILOT.md) |\n[Cline](.\u002Fdocs\u002Fintegrations\u002FCLINE.md) |\n[Continue](.\u002Fdocs\u002Fintegrations\u002FCONTINUE.md)\n\n**AI Platforms:**\n[Dify](.\u002Fdocs\u002Fintegrations\u002FDIFY.md) |\n[Coze](.\u002Fdocs\u002Fintegrations\u002FCOZE.md) |\n[n8n](.\u002Fdocs\u002Fintegrations\u002FN8N.md) |\n[ChatGPT](.\u002Fdocs\u002Fintegrations\u002FCHATGPT.md) |\n[LangChain](.\u002Fdocs\u002Fintegrations\u002FLANGCHAIN.md)\n\n**Desktop Apps:**\n[Cherry Studio](.\u002Fdocs\u002Fintegrations\u002FCHERRY-STUDIO.md) |\n[LM Studio](.\u002Fdocs\u002Fintegrations\u002FLM-STUDIO.md) |\n[Jan](.\u002Fdocs\u002Fintegrations\u002FJAN.md) |\n[Ollama](.\u002Fdocs\u002Fintegrations\u002FOLLAMA.md)\n\n**Messaging:**\n[Slack](.\u002Fdocs\u002Fintegrations\u002FSLACK.md) |\n[Discord](.\u002Fdocs\u002Fintegrations\u002FDISCORD.md)\n\n**Tools:**\n[MCP Inspector](.\u002Fdocs\u002Fintegrations\u002FMCP-INSPECTOR.md) |\n[Postman](.\u002Fdocs\u002Fintegrations\u002FPOSTMAN.md)\n\n> 📁 [View all 55 integration guides](.\u002Fdocs\u002Fintegrations\u002F) | 中文版本请在对应文档名后加 `.zh-CN`\n\n### Advanced\n- [Security Guide](.\u002Fdocs\u002Fguides\u002Fsecurity.md)\n- [Multi-tenant Guide](.\u002Fdocs\u002Fguides\u002Fmulti-tenant.md)\n- [Architecture](.\u002Fdocs\u002Fdevelopment\u002Farchitecture.md)\n- [Troubleshooting](.\u002Fdocs\u002Foperations\u002Ftroubleshooting.md)\n\n## 🤝 Contributing\n\nContributions are welcome! Please read our [Contributing Guide](.\u002FCONTRIBUTING.md) before submitting a Pull Request.\n\n```bash\n# Clone the repository\ngit clone https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\u002Funiversal-db-mcp.git\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run tests\nnpm test\n```\n\n## 📄 License\n\nThis project is licensed under the [MIT License](.\u002FLICENSE).\n\n## 🌟 Star History\n\nIf you find this project useful, please consider giving it a star! Your support helps us continue improving Universal DB MCP.\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FAnarkh-Lee_universal-db-mcp_readme_9d489e138f1d.png)](https:\u002F\u002Fstar-history.com\u002F#Anarkh-Lee\u002Funiversal-db-mcp&Date)\n\n## 📝 Changelog\n\nSee [CHANGELOG.md](.\u002FCHANGELOG.md) for a detailed version history.\n\n---\n\n\u003Cp align=\"center\">\n Made with ❤️ by \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\">Anarkh-Lee\u003C\u002Fa>\n\u003C\u002Fp>\n","\u003Cp align=\"center\">\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FAnarkh-Lee_universal-db-mcp_readme_a27bbf346ffa.png\" alt=\"Universal DB MCP Logo\" width=\"200\">\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">Universal DB MCP\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n \u003Cstrong>用自然语言将AI连接到您的数据库\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n 一个实现模型上下文协议（MCP）和HTTP API的通用数据库连接器，使AI助手能够使用自然语言查询和分析您的数据库。与Claude Desktop、Cursor、Windsurf、VS Code、ChatGPT等50多个平台兼容。\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Funiversal-db-mcp\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Funiversal-db-mcp.svg?style=flat-square&color=blue\" alt=\"npm版本\">\u003C\u002Fa>\n \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Funiversal-db-mcp\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Funiversal-db-mcp.svg?style=flat-square&color=green\" alt=\"npm下载量\">\u003C\u002Fa>\n \u003Ca href=\"https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg?style=flat-square\" alt=\"许可证：MIT\">\u003C\u002Fa>\n \u003Ca href=\"https:\u002F\u002Fnodejs.org\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D20.0.0-brightgreen?style=flat-square\" alt=\"Node.js版本\">\u003C\u002Fa>\n \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\u002Funiversal-db-mcp\u002Fstargazers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FAnarkh-Lee\u002Funiversal-db-mcp?style=flat-square\" alt=\"GitHub星标\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n \u003Ca href=\"#-features\">功能\u003C\u002Fa> •\n \u003Ca href=\"#-quick-start\">快速入门\u003C\u002Fa> •\n \u003Ca href=\"#-supported-databases\">支持的数据库\u003C\u002Fa> •\n \u003Ca href=\"#-documentation\">文档\u003C\u002Fa> •\n \u003Ca href=\"#-contributing\">贡献\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n \u003Ca href=\".\u002FREADME.md\">English\u003C\u002Fa> | \u003Ca href=\".\u002FREADME.zh-CN.md\">中文文档\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\n## 为什么选择Universal DB MCP？\n\n想象一下，您可以这样问您的AI助手：“本月按订单金额排名前10位的客户有哪些？”然后立即从您的数据库中获取结果——无需编写SQL语句。Universal DB MCP通过模型上下文协议（MCP）和HTTP API，将AI助手与您的数据库无缝连接，从而实现这一功能。\n\n```\n您：“过去30天内注册用户的平均订单金额是多少？”\n\nAI：让我为您查询一下……\n\n┌─────────────────────────────────────┐\n│ 平均订单金额：$127.45 │\n│ 新用户总数：1,247 │\n│ 有订单的用户：892人（71.5%） │\n└─────────────────────────────────────┘\n```\n\n## ✨ 功能\n\n- **支持17种数据库** - MySQL、PostgreSQL、Redis、Oracle、SQL Server、MongoDB、SQLite以及10种中国国产数据库\n- **集成55+个平台** - 兼容Claude Desktop、Cursor、VS Code、ChatGPT、Dify等[50多个平台](#-supported-platforms)\n- **灵活的架构** - 支持两种启动模式（stdio\u002Fhttp），提供四种访问方式：MCP stdio、MCP SSE、MCP可流式HTTP和REST API\n- **安全优先** - 默认为只读模式，防止意外修改数据\n- **智能缓存** - 模式缓存并可配置TTL，实现超快性能\n- **批量查询优化** - 大型数据库的模式检索速度提升高达100倍\n- **模式增强** - 表注释、隐式关系推断，提高Text2SQL准确性\n- **多模式支持** - 自动发现所有用户模式（PostgreSQL、SQL Server、Oracle、达梦等）\n- **数据脱敏** - 自动保护敏感数据（电话、邮箱、身份证、银行卡等）\n- **连接稳定性** - 连接池、TCP Keep-Alive以及长会话自动重连机制\n\n### 性能提升\n\n| 表数量 | 优化前 | 优化后 | 提升 |\n|--------|--------|-------|-------------|\n| 50张表 | ~5秒 | ~200毫秒 | **快25倍** |\n| 100张表 | ~10秒 | ~300毫秒 | **快33倍** |\n| 500张表 | ~50秒 | ~500毫秒 | **快100倍** |\n\n## 🚀 快速入门\n\n### 安装\n\n```bash\nnpm install -g universal-db-mcp\n```\n\n### MCP模式（Claude Desktop）\n\n将以下内容添加到您的Claude Desktop配置文件中：\n\n- **macOS**: `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"my-database\": {\n \"command\": \"npx\",\n \"args\": [\n \"universal-db-mcp\",\n \"--type\", \"mysql\",\n \"--host\", \"localhost\",\n \"--port\", \"3306\",\n \"--user\", \"root\",\n \"--password\", \"your_password\",\n \"--database\", \"your_database\"\n ]\n }\n }\n}\n```\n\n重启Claude Desktop，即可开始提问：\n\n- “给我看看users表的结构”\n- “统计最近7天内的订单数”\n- “找出销量前5名的产品”\n\n### HTTP API模式\n\n```bash\n# 设置环境变量\nexport MODE=http\nexport HTTP_PORT=3000\nexport API_KEYS=your-secret-key\n\n# 启动服务器\nnpx universal-db-mcp\n```\n\n```bash\n# 测试API\ncurl http:\u002F\u002Flocalhost:3000\u002Fapi\u002Fhealth\n```\n\n### MCP SSE模式（Dify及远程访问）\n\n在HTTP模式下运行时，服务器还会通过SSE（服务器发送事件）和可流式HTTP暴露MCP协议端点。这使得像Dify这样的平台可以直接使用MCP协议进行连接。\n\n**SSE端点（旧版）：**\n```\nGET http:\u002F\u002Flocalhost:3000\u002Fsse?type=mysql&host=localhost&port=3306&user=root&password=xxx&database=mydb\n```\n\n**可流式HTTP端点（MCP 2025规范，推荐使用）：**\n```\nPOST http:\u002F\u002Flocalhost:3000\u002Fmcp\nHeaders:\n X-DB-Type: mysql\n X-DB-Host: localhost\n X-DB-Port: 3306\n X-DB-User: root\n X-DB-Password: your_password\n X-DB-Database: your_database\nBody: MCP JSON-RPC请求\n```\n\n| 端点 | 方法 | 描述 |\n|----------|--------|-------------|\n| `\u002Fsse` | GET | 建立SSE连接（旧版） |\n| `\u002Fsse\u002Fmessage` | POST | 向SSE会话发送消息 |\n| `\u002Fmcp` | POST | 可流式HTTP端点（推荐） |\n| `\u002Fmcp` | GET | 用于可流式HTTP的SSE流 |\n| `\u002Fmcp` | DELETE | 关闭会话 |\n\n详细设置请参阅[Dify集成指南](.\u002Fdocs\u002Fintegrations\u002FDIFY.md)。\n\n## 📊 支持的数据库\n\n| 数据库 | 类型 | 默认端口 | 分类 |\n|----------|------|--------------|----------|\n| MySQL | `mysql` | 3306 | 开源 |\n| PostgreSQL | `postgres` | 5432 | 开源 |\n| Redis | `redis` | 6379 | NoSQL |\n| Oracle | `oracle` | 1521 | 商业 |\n| SQL Server | `sqlserver` | 1433 | 商业 |\n| MongoDB | `mongodb` | 27017 | NoSQL |\n| SQLite | `sqlite` | - | 嵌入式 |\n| 达梦 | `dm` | 5236 | 中文 |\n| KingbaseES | `kingbase` | 54321 | 中文 |\n| GaussDB | `gaussdb` | 5432 | 中文（华为） |\n| OceanBase | `oceanbase` | 2881 | 中文（蚂蚁集团） |\n| TiDB | `tidb` | 4000 | 分布式 |\n| ClickHouse | `clickhouse` | 8123 | OLAP |\n| PolarDB | `polardb` | 3306 | 云服务（阿里巴巴） |\n| Vastbase | `vastbase` | 5432 | 中文 |\n| HighGo | `highgo` | 5866 | 中文 |\n| GoldenDB | `goldendb` | 3306 | 中文（中兴通讯） |\n\n## 🏗️ 架构\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│ 通用数据库 MCP │\n├─────────────────────────────────────────────────────────────────────────┤\n│ │\n│ 启动模式： │\n│ ┌────────────────────────────┬────────────────────────────────────┐ │\n│ │ 标准输入输出模式 │ HTTP 模式 │ │\n│ │ (npm run start:mcp) │ (npm run start:http) │ │\n│ └─────────────┬──────────────┴───────────────┬────────────────────┘ │\n│ │ │ │\n│ ▼ ▼ │\n│ ┌─────────────────────────┐ ┌───────────────────────────────────┐ │\n│ │ MCP 协议 │ │ HTTP 服务器 │ │\n│ │ (stdio 传输) │ │ │ │\n│ │ │ │ ┌─────────────────────────────┐ │ │\n│ │ 工具： │ │ │ MCP 协议 │ │ │\n│ │ • execute_query │ │ │ (SSE \u002F 流式 HTTP) │ │ │\n│ │ • get_schema │ │ │ │ │ │\n│ │ • get_table_info │ │ │ 工具：(与 stdio 相同) │ │ │\n│ │ • clear_cache │ │ │ • execute_query │ │ │\n│ │ • get_enum_values │ │ │ • get_schema │ │ │\n│ │ • get_sample_data │ │ │ • get_table_info │ │ │\n│ │ • connect_database │ │ │ • clear_cache │ │ │\n│ │ • disconnect_database │ │ │ • get_enum_values │ │ │\n│ │ • get_sample_data │ │ │ • connect_database │ │ │\n│ │ • get_connection_status│ │ │ • disconnect_database │ │ │\n│ │ │ │ │ • get_connection_status │ │ │\n│ │ 对于：Claude Desktop, │ │ │ │ │ │\n│ │ Cursor, 等等. │ │ │ │ │ │\n│ └─────────────┬───────────┘ │ │ │ │ │\n│ │ │ └──────────────┬──────────────┘ │ │\n│ │ │ │ │ │\n│ │ │ ┌──────────────┴──────────────┐ │ │\n│ │ │ │ REST API │ │ │\n│ │ │ │ │ │ │\n│ │ │ │ 端点： │ │ │\n│ │ │ │ • \u002Fapi\u002Fconnect │ │ │\n│ │ │ │ • \u002Fapi\u002Fquery │ │ │\n│ │ │ │ • \u002Fapi\u002Fschema │ │ │\n│ │ │ │ • ... (10+ 端点) │ │ │\n│ │ │ │ │ │ │\n│ │ │ │ 对于：Coze, n8n, 自定义 │ │ │\n│ │ │ └──────────────┬──────────────┘ │ │\n│ │ └─────────────────┼─────────────────┘ │\n│ │ │ │\n│ └──────────────────┬───────────────┘ │\n│ ▼ │\n│ ┌──────────────────────────────────────────────────────────────────┐ │\n│ │ 核心业务逻辑 │ │\n│ │ • 查询执行 • 模式缓存 │ │\n│ │ • 安全验证 • 连接管理 │ │\n│ └──────────────────────────────────┬───────────────────────────────┘ │\n│ ▼ │\n│ ┌──────────────────────────────────────────────────────────────────┐ │\n│ │ 数据库适配层 │ │\n│ │ MySQL │ PostgreSQL │ Redis │ Oracle │ MongoDB │ SQLite │ ... │ │\n│ │ (连接池 + TCP Keep-Alive + 自动重试) │ │\n│ └──────────────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\n## 🔒 安全性\n\n默认情况下，通用数据库 MCP 以 **只读模式** 运行，阻止所有写操作（INSERT、UPDATE、DELETE、DROP 等）。\n\n### 权限模式\n\n支持细粒度的权限控制，可灵活配置：\n\n| 模式 | 允许的操作 | 描述 |\n|------|-------------------|-------------|\n| `safe`（默认） | SELECT | 只读，最安全 |\n| `readwrite` | SELECT、INSERT、UPDATE | 读\u002F写但无删除 |\n| `full` | 所有操作 | 完全控制（危险！） |\n| `custom` | 自定义组合 | 通过 `--permissions` 指定 |\n\n**权限类型：**\n- `read` - SELECT 查询（始终包含）\n- `insert` - INSERT、REPLACE\n- `update` - UPDATE\n- `delete` - DELETE、TRUNCATE\n- `ddl` - CREATE、ALTER、DROP、RENAME\n\n**使用示例：**\n\n```bash\n# 只读模式（默认）\nnpx universal-db-mcp --type mysql ...\n\n# 读\u002F写但无删除\nnpx universal-db-mcp --type mysql --permission-mode readwrite ...\n\n# 自定义：仅读和插入\nnpx universal-db-mcp --type mysql --permissions read,insert ...\n\n# 全部控制（等同于 --danger-allow-write）\nnpx universal-db-mcp --type mysql --permission-mode full ...\n```\n\n**按传输方式配置权限：**\n\n> ⚠️ 不同传输方式使用不同的参数命名规范！\n\n| 传输方式 | 参数位置 | 权限模式 | 自定义权限 |\n|-----------|-------------------|-----------------|-------------------|\n| STDIO（Claude Desktop） | CLI 参数 | `--permission-mode` | `--permissions` |\n| SSE（Dify 等） | URL 查询 | `permissionMode` | `permissions` |\n| 流式 HTTP | HTTP 头 | `X-DB-Permission-Mode` | `X-DB-Permissions` |\n| REST API | JSON 请求体 | `permissionMode` | `permissions` |\n\n**最佳实践：**\n- 生产环境中切勿启用写入模式\n- 使用专用的只读数据库账号\n- 通过 VPN 或堡垒主机进行连接\n- 定期审计查询日志\n\n## 🔌 支持的平台\n\n通用数据库 MCP 可与任何支持 MCP 协议或 REST API 的平台配合使用。以下是完整列表：\n\n### 基于 AI 的代码编辑器与 IDE\n\n| 平台 | 访问方式 | 描述 | 指南 |\n|----------|---------------|-------------|-------|\n| [Cursor](https:\u002F\u002Fcursor.sh\u002F) | MCP stdio | 具有内置 MCP 支持的 AI 驱动代码编辑器 | [EN](.\u002Fdocs\u002Fintegrations\u002FCURSOR.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCURSOR.zh-CN.md) |\n| [Windsurf](https:\u002F\u002Fcodeium.com\u002Fwindsurf) | MCP stdio | Codeium 的 AI IDE，配备 Cascade 代理 | [EN](.\u002Fdocs\u002Fintegrations\u002FWINDSURF.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FWINDSURF.zh-CN.md) |\n| [VS Code](https:\u002F\u002Fcode.visualstudio.com\u002F) | MCP stdio \u002F REST API | 通过 GitHub Copilot 代理模式或 Cline\u002FContinue 扩展 | [EN](.\u002Fdocs\u002Fintegrations\u002FVSCODE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FVSCODE.zh-CN.md) |\n| [Zed](https:\u002F\u002Fzed.dev\u002F) | MCP stdio | 高性能开源代码编辑器 | [EN](.\u002Fdocs\u002Fintegrations\u002FZED.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FZED.zh-CN.md) |\n| [IntelliJ IDEA](https:\u002F\u002Fwww.jetbrains.com\u002Fidea\u002F) | MCP stdio | JetBrains IDE，支持 MCP（2025.1 及以上版本） | [EN](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.zh-CN.md) |\n| [PyCharm](https:\u002F\u002Fwww.jetbrains.com\u002Fpycharm\u002F) | MCP stdio | JetBrains 的 Python IDE | [EN](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.zh-CN.md) |\n| [WebStorm](https:\u002F\u002Fwww.jetbrains.com\u002Fwebstorm\u002F) | MCP stdio | JetBrains 的 JavaScript IDE | [EN](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.zh-CN.md) |\n| [Android Studio](https:\u002F\u002Fdeveloper.android.com\u002Fstudio) | MCP stdio | 通过 JetBrains 的 MCP 插件 | [EN](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.zh-CN.md) |\n| [Neovim](https:\u002F\u002Fneovim.io\u002F) | MCP stdio | 通过 MCPHub.nvim 插件 | [EN](.\u002Fdocs\u002Fintegrations\u002FNEOVIM.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FNEOVIM.zh-CN.md) |\n| [Emacs](https:\u002F\u002Fwww.gnu.org\u002Fsoftware\u002Femacs\u002F) | MCP stdio | 通过 mcp.el 包 | [EN](.\u002Fdocs\u002Fintegrations\u002FEMACS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FEMACS.zh-CN.md) |\n\n### AI 编程助手\n\n| 平台 | 访问方式 | 描述 | 指南 |\n|----------|---------------|-------------|-------|\n| [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) | MCP stdio | Anthropic 的代理式编程工具 | [EN](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-CODE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-CODE.zh-CN.md) |\n| [GitHub Copilot](https:\u002F\u002Fgithub.com\u002Ffeatures\u002Fcopilot) | MCP stdio | VS Code\u002FJetBrains 中的代理模式 | [EN](.\u002Fdocs\u002Fintegrations\u002FGITHUB-COPILOT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FGITHUB-COPILOT.zh-CN.md) |\n| [Cline](https:\u002F\u002Fgithub.com\u002Fcline\u002Fcline) | MCP stdio \u002F REST API | 适用于 VS Code 的自主编程代理 | [EN](.\u002Fdocs\u002Fintegrations\u002FCLINE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCLINE.zh-CN.md) |\n| [Continue](https:\u002F\u002Fcontinue.dev\u002F) | MCP stdio | 开源 AI 代码助手 | [EN](.\u002Fdocs\u002Fintegrations\u002FCONTINUE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCONTINUE.zh-CN.md) |\n| [Roo Code](https:\u002F\u002Fgithub.com\u002Froovet\u002Froo-code) | MCP stdio | Cline 的 VS Code 分支 | [EN](.\u002Fdocs\u002Fintegrations\u002FROO-CODE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FROO-CODE.zh-CN.md) |\n| [Sourcegraph Cody](https:\u002F\u002Fsourcegraph.com\u002Fcody) | MCP stdio | AI 编程助手 | [EN](.\u002Fdocs\u002Fintegrations\u002FSOURCEGRAPH-CODY.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FSOURCEGRAPH-CODY.zh-CN.md) |\n| [Amazon Q Developer](https:\u002F\u002Faws.amazon.com\u002Fq\u002Fdeveloper\u002F) | MCP stdio | AWS 的 AI 编程助手 | [EN](.\u002Fdocs\u002Fintegrations\u002FAMAZON-Q-DEVELOPER.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FAMAZON-Q-DEVELOPER.zh-CN.md) |\n| [Devin](https:\u002F\u002Fdevin.ai\u002F) | MCP stdio | AI 软件工程师 | [EN](.\u002Fdocs\u002Fintegrations\u002FDEVIN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FDEVIN.zh-CN.md) |\n| [Goose](https:\u002F\u002Fgithub.com\u002Fblock\u002Fgoose) | MCP stdio | Block 的 AI 编程代理 | [EN](.\u002Fdocs\u002Fintegrations\u002FGOOSE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FGOOSE.zh-CN.md) |\n| [Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli) | MCP stdio | Google 的命令行 AI 工具 | [EN](.\u002Fdocs\u002Fintegrations\u002FGEMINI-CLI.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FGEMINI-CLI.zh-CN.md) |\n\n### 桌面 AI 聊天应用\n\n| 平台 | 访问方式 | 描述 | 指南 |\n|----------|---------------|-------------|-------|\n| [Claude Desktop](https:\u002F\u002Fclaude.ai\u002Fdownload) | MCP stdio | Anthropic 官方桌面应用 | [EN](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-DESKTOP.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-DESKTOP.zh-CN.md) |\n| [ChatGPT Desktop](https:\u002F\u002Fopenai.com\u002Fchatgpt\u002Fdesktop\u002F) | MCP SSE\u002FStreamable HTTP | OpenAI 的桌面应用，配备 MCP 连接器 | [EN](.\u002Fdocs\u002Fintegrations\u002FCHATGPT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCHATGPT.zh-CN.md) |\n| [Cherry Studio](https:\u002F\u002Fgithub.com\u002Fkangfenmao\u002Fcherry-studio) | MCP stdio | 多模型桌面聊天应用 | [EN](.\u002Fdocs\u002Fintegrations\u002FCHERRY-STUDIO.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCHERRY-STUDIO.zh-CN.md) |\n| [LM Studio](https:\u002F\u002Flmstudio.ai\u002F) | MCP stdio | 在本地运行 LLM，并支持 MCP | [EN](.\u002Fdocs\u002Fintegrations\u002FLM-STUDIO.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FLM-STUDIO.zh-CN.md) |\n| [Jan](https:\u002F\u002Fjan.ai\u002F) | MCP stdio | 开源的 ChatGPT 替代品 | [EN](.\u002Fdocs\u002Fintegrations\u002FJAN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJAN.zh-CN.md) |\n| [Msty](https:\u002F\u002Fmsty.app\u002F) | MCP stdio | 桌面 AI 聊天应用 | [EN](.\u002Fdocs\u002Fintegrations\u002FMSTY.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FMSTY.zh-CN.md) |\n| [LibreChat](https:\u002F\u002Fgithub.com\u002Fdanny-avila\u002FLibreChat) | MCP stdio | 开源聊天界面 | [EN](.\u002Fdocs\u002Fintegrations\u002FLIBRECHAT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FLIBRECHAT.zh-CN.md) |\n| [Witsy](https:\u002F\u002Fwitsy.app\u002F) | MCP stdio | 桌面 AI 助手 | [EN](.\u002Fdocs\u002Fintegrations\u002FWITSY.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FWITSY.zh-CN.md) |\n| [5ire](https:\u002F\u002Fgithub.com\u002F5ire-tech\u002F5ire) | MCP stdio | 跨平台 AI 聊天 | [EN](.\u002Fdocs\u002Fintegrations\u002F5IRE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002F5IRE.zh-CN.md) |\n| [ChatMCP](https:\u002F\u002Fgithub.com\u002Fdaodao97\u002Fchatmcp) | MCP stdio | 专注于 MCP 的聊天 UI | [EN](.\u002Fdocs\u002Fintegrations\u002FCHATMCP.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCHATMCP.zh-CN.md) |\n| [HyperChat](https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat) | MCP stdio | 多平台聊天应用 | [EN](.\u002Fdocs\u002Fintegrations\u002FHYPERCHAT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FHYPERCHAT.zh-CN.md) |\n| [Tome](https:\u002F\u002Fgithub.com\u002Frunebook\u002Ftome) | MCP stdio | 用于本地 LLM 的 macOS 应用 | [EN](.\u002Fdocs\u002Fintegrations\u002FTOME.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FTOME.zh-CN.md) |\n\n### 基于Web的AI平台\n\n| 平台 | 访问方式 | 描述 | 指南 |\n|----------|---------------|-------------|-------|\n| [Claude.ai](https:\u002F\u002Fclaude.ai\u002F) | MCP SSE\u002F可流式HTTP | Anthropic的网页界面 | [EN](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-AI.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-AI.zh-CN.md) |\n| [ChatGPT](https:\u002F\u002Fchat.openai.com\u002F) | MCP SSE\u002F可流式HTTP | 通过自定义连接器 | [EN](.\u002Fdocs\u002Fintegrations\u002FCHATGPT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCHATGPT.zh-CN.md) |\n| [Dify](https:\u002F\u002Fdify.ai\u002F) | MCP SSE\u002F可流式HTTP | LLM应用开发平台 | [EN](.\u002Fdocs\u002Fintegrations\u002FDIFY.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FDIFY.zh-CN.md) |\n| [Coze](https:\u002F\u002Fwww.coze.com\u002F) | REST API | 字节跳动的AI机器人平台 | [EN](.\u002Fdocs\u002Fintegrations\u002FCOZE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCOZE.zh-CN.md) |\n| [n8n](https:\u002F\u002Fn8n.io\u002F) | REST API \u002F MCP | 工作流自动化平台 | [EN](.\u002Fdocs\u002Fintegrations\u002FN8N.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FN8N.zh-CN.md) |\n| [Replit](https:\u002F\u002Freplit.com\u002F) | MCP stdio | 带有AI代理的在线IDE | [EN](.\u002Fdocs\u002Fintegrations\u002FREPLIT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FREPLIT.zh-CN.md) |\n| [MindPal](https:\u002F\u002Fmindpal.io\u002F) | MCP SSE\u002F可流式HTTP | 无代码AI代理构建工具 | [EN](.\u002Fdocs\u002Fintegrations\u002FMINDPAL.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FMINDPAL.zh-CN.md) |\n\n### 代理框架与SDK\n\n| 平台 | 访问方式 | 描述 | 指南 |\n|----------|---------------|-------------|-------|\n| [LangChain](https:\u002F\u002Flangchain.com\u002F) | MCP stdio | 流行的LLM框架 | [EN](.\u002Fdocs\u002Fintegrations\u002FLANGCHAIN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FLANGCHAIN.zh-CN.md) |\n| [Smolagents](https:\u002F\u002Fgithub.com\u002Fhuggingface\u002Fsmolagents) | MCP stdio | Hugging Face代理库 | [EN](.\u002Fdocs\u002Fintegrations\u002FSMOLAGENTS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FSMOLAGENTS.zh-CN.md) |\n| [OpenAI Agents SDK](https:\u002F\u002Fplatform.openai.com\u002F) | MCP SSE\u002F可流式HTTP | OpenAI的代理框架 | [EN](.\u002Fdocs\u002Fintegrations\u002FOPENAI-AGENTS-SDK.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FOPENAI-AGENTS-SDK.zh-CN.md) |\n| [Amazon Bedrock Agents](https:\u002F\u002Faws.amazon.com\u002Fbedrock\u002F) | MCP SSE\u002F可流式HTTP | AWS AI代理服务 | [EN](.\u002Fdocs\u002Fintegrations\u002FAMAZON-BEDROCK-AGENTS.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FAMAZON-BEDROCK-AGENTS.zh-CN.md) |\n| [Google ADK](https:\u002F\u002Fcloud.google.com\u002F) | MCP stdio | Google的代理开发工具包 | [EN](.\u002Fdocs\u002Fintegrations\u002FGOOGLE-ADK.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FGOOGLE-ADK.zh-CN.md) |\n| [Vercel AI SDK](https:\u002F\u002Fsdk.vercel.ai\u002F) | MCP stdio | Vercel的AI开发工具包 | [EN](.\u002Fdocs\u002Fintegrations\u002FVERCEL-AI-SDK.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FVERCEL-AI-SDK.zh-CN.md) |\n| [Spring AI](https:\u002F\u002Fspring.io\u002Fprojects\u002Fspring-ai) | MCP stdio | Java\u002FSpring AI框架 | [EN](.\u002Fdocs\u002Fintegrations\u002FSPRING-AI.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FSPRING-AI.zh-CN.md) |\n\n### CLI工具与终端\n\n| 平台 | 访问方式 | 描述 | 指南 |\n|----------|---------------|-------------|-------|\n| [Claude Code CLI](https:\u002F\u002Fclaude.ai\u002Fcode) | MCP stdio | 基于终端的编码代理 | [EN](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-CODE.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-CODE.zh-CN.md) |\n| [Warp](https:\u002F\u002Fwww.warp.dev\u002F) | MCP stdio | AI驱动的终端 | [EN](.\u002Fdocs\u002Fintegrations\u002FWARP.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FWARP.zh-CN.md) |\n| [Oterm](https:\u002F\u002Fgithub.com\u002Fggozad\u002Foterm) | MCP stdio | 通过CLI与Ollama聊天 | [EN](.\u002Fdocs\u002Fintegrations\u002FOTERM.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FOTERM.zh-CN.md) |\n| [MCPHost](https:\u002F\u002Fgithub.com\u002Fmark3labs\u002Fmcphost) | MCP stdio | 通过CLI与LLM对话 | [EN](.\u002Fdocs\u002Fintegrations\u002FMCPHOST.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FMCPHOST.zh-CN.md) |\n\n### 生产力与自动化\n\n| 平台 | 访问方式 | 描述 | 指南 |\n|----------|---------------|-------------|-------|\n| [Raycast](https:\u002F\u002Fraycast.com\u002F) | MCP stdio | macOS生产力启动器 | [EN](.\u002Fdocs\u002Fintegrations\u002FRAYCAST.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FRAYCAST.zh-CN.md) |\n| [Notion](https:\u002F\u002Fnotion.so\u002F) | MCP SSE\u002F可流式HTTP | 带有AI集成的工作空间 | [EN](.\u002Fdocs\u002Fintegrations\u002FNOTION.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FNOTION.zh-CN.md) |\n| [Obsidian](https:\u002F\u002Fobsidian.md\u002F) | MCP stdio | 通过MCP Tools插件 | [EN](.\u002Fdocs\u002Fintegrations\u002FOBSIDIAN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FOBSIDIAN.zh-CN.md) |\n| [Home Assistant](https:\u002F\u002Fwww.home-assistant.io\u002F) | MCP stdio | 家庭自动化平台 | [EN](.\u002Fdocs\u002Fintegrations\u002FHOME-ASSISTANT.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FHOME-ASSISTANT.zh-CN.md) |\n\n### 消息平台集成\n\n| 平台 | 访问方式 | 描述 | 指南 |\n|----------|---------------|-------------|-------|\n| [Slack](https:\u002F\u002Fslack.com\u002F) | MCP stdio \u002F REST API | 通过Slack MCP机器人 | [EN](.\u002Fdocs\u002Fintegrations\u002FSLACK.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FSLACK.zh-CN.md) |\n| [Discord](https:\u002F\u002Fdiscord.com\u002F) | MCP stdio \u002F REST API | 通过Discord MCP机器人 | [EN](.\u002Fdocs\u002Fintegrations\u002FDISCORD.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FDISCORD.zh-CN.md) |\n| [Mattermost](https:\u002F\u002Fmattermost.com\u002F) | MCP stdio | 开源消息平台 | [EN](.\u002Fdocs\u002Fintegrations\u002FMATTERMOST.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FMATTERMOST.zh-CN.md) |\n\n### 本地LLM运行工具\n\n| 平台 | 访问方式 | 描述 | 指南 |\n|----------|---------------|-------------|-------|\n| [Ollama](https:\u002F\u002Follama.ai\u002F) | MCP stdio | 运行本地LLM | [EN](.\u002Fdocs\u002Fintegrations\u002FOLLAMA.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FOLLAMA.zh-CN.md) |\n| [LM Studio](https:\u002F\u002Flmstudio.ai\u002F) | MCP stdio | 本地LLM桌面应用 | [EN](.\u002Fdocs\u002Fintegrations\u002FLM-STUDIO.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FLM-STUDIO.zh-CN.md) |\n| [Jan](https:\u002F\u002Fjan.ai\u002F) | MCP stdio | 离线版ChatGPT替代品 | [EN](.\u002Fdocs\u002Fintegrations\u002FJAN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FJAN.zh-CN.md) |\n\n### 开发与测试工具\n\n| 平台 | 访问方式 | 描述 | 指南 |\n|----------|---------------|-------------|-------|\n| [MCP Inspector](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Finspector) | MCP stdio | 官方MCP调试工具 | [EN](.\u002Fdocs\u002Fintegrations\u002FMCP-INSPECTOR.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FMCP-INSPECTOR.zh-CN.md) |\n| [Postman](https:\u002F\u002Fpostman.com\u002F) | REST API \u002F MCP | API测试平台 | [EN](.\u002Fdocs\u002Fintegrations\u002FPOSTMAN.md) \u002F [中文](.\u002Fdocs\u002Fintegrations\u002FPOSTMAN.zh-CN.md) |\n\n> **注意**: 任何兼容MCP的客户端都可以通过stdio（本地）或SSE\u002F可流式HTTP（远程）进行连接。任何HTTP客户端都可以使用REST API。\n\n## 📚 文档\n\n### 入门\n- [安装指南](.\u002Fdocs\u002Fgetting-started\u002Finstallation.md)\n- [快速入门](.\u002Fdocs\u002Fgetting-started\u002Fquick-start.md)\n- [配置](.\u002Fdocs\u002Fgetting-started\u002Fconfiguration.md)\n- [使用示例](.\u002Fdocs\u002Fgetting-started\u002Fexamples.md)\n\n### 部署\n- [部署概述](.\u002Fdocs\u002Fdeployment\u002FREADME.md)\n- [本地部署](.\u002Fdocs\u002Fdeployment\u002Flocal.md)\n- [Docker部署](.\u002Fdocs\u002Fdeployment\u002Fdocker.md)\n- [云部署](.\u002Fdocs\u002Fdeployment\u002Fcloud\u002F)\n\n### 数据库指南\n- [数据库支持概述](.\u002Fdocs\u002Fdatabases\u002FREADME.md)\n- [MySQL](.\u002Fdocs\u002Fdatabases\u002Fmysql.md)\n- [PostgreSQL](.\u002Fdocs\u002Fdatabases\u002Fpostgresql.md)\n- [更多数据库...](.\u002Fdocs\u002Fdatabases\u002F)\n\n### HTTP API\n- [API 参考](.\u002Fdocs\u002Fhttp-api\u002FAPI_REFERENCE.md)\n- [部署指南](.\u002Fdocs\u002Fhttp-api\u002FDEPLOYMENT.md)\n\n### 集成\n\n**AI 编辑器与 IDE：**\n[Cursor](.\u002Fdocs\u002Fintegrations\u002FCURSOR.md) |\n[VS Code](.\u002Fdocs\u002Fintegrations\u002FVSCODE.md) |\n[JetBrains](.\u002Fdocs\u002Fintegrations\u002FJETBRAINS.md) |\n[Windsurf](.\u002Fdocs\u002Fintegrations\u002FWINDSURF.md) |\n[Zed](.\u002Fdocs\u002Fintegrations\u002FZED.md) |\n[Neovim](.\u002Fdocs\u002Fintegrations\u002FNEOVIM.md) |\n[Emacs](.\u002Fdocs\u002Fintegrations\u002FEMACS.md)\n\n**AI 助手：**\n[Claude Desktop](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-DESKTOP.md) |\n[Claude Code](.\u002Fdocs\u002Fintegrations\u002FCLAUDE-CODE.md) |\n[GitHub Copilot](.\u002Fdocs\u002Fintegrations\u002FGITHUB-COPILOT.md) |\n[Cline](.\u002Fdocs\u002Fintegrations\u002FCLINE.md) |\n[Continue](.\u002Fdocs\u002Fintegrations\u002FCONTINUE.md)\n\n**AI 平台：**\n[Dify](.\u002Fdocs\u002Fintegrations\u002FDIFY.md) |\n[Coze](.\u002Fdocs\u002Fintegrations\u002FCOZE.md) |\n[n8n](.\u002Fdocs\u002Fintegrations\u002FN8N.md) |\n[ChatGPT](.\u002Fdocs\u002Fintegrations\u002FCHATGPT.md) |\n[LangChain](.\u002Fdocs\u002Fintegrations\u002FLANGCHAIN.md)\n\n**桌面应用：**\n[Cherry Studio](.\u002Fdocs\u002Fintegrations\u002FCHERRY-STUDIO.md) |\n[LM Studio](.\u002Fdocs\u002Fintegrations\u002FLM-STUDIO.md) |\n[Jan](.\u002Fdocs\u002Fintegrations\u002FJAN.md) |\n[Ollama](.\u002Fdocs\u002Fintegrations\u002FOLLAMA.md)\n\n**消息工具：**\n[Slack](.\u002Fdocs\u002Fintegrations\u002FSLACK.md) |\n[Discord](.\u002Fdocs\u002Fintegrations\u002FDISCORD.md)\n\n**工具：**\n[MCP Inspector](.\u002Fdocs\u002Fintegrations\u002FMCP-INSPECTOR.md) |\n[Postman](.\u002Fdocs\u002Fintegrations\u002FPOSTMAN.md)\n\n> 📁 [查看全部 55 篇集成指南](.\u002Fdocs\u002Fintegrations\u002F) | 中文版本请在对应文档名后加 `.zh-CN`\n\n### 高级\n- [安全指南](.\u002Fdocs\u002Fguides\u002Fsecurity.md)\n- [多租户指南](.\u002Fdocs\u002Fguides\u002Fmulti-tenant.md)\n- [架构](.\u002Fdocs\u002Fdevelopment\u002Farchitecture.md)\n- [故障排除](.\u002Fdocs\u002Foperations\u002Ftroubleshooting.md)\n\n## 🤝 贡献\n\n我们欢迎任何贡献！请在提交 Pull Request 之前阅读我们的 [贡献指南](.\u002FCONTRIBUTING.md)。\n\n```bash\n# 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\u002Funiversal-db-mcp.git\n\n# 安装依赖\nnpm install\n\n# 构建\nnpm run build\n\n# 运行测试\nnpm test\n```\n\n## 📄 许可证\n\n本项目采用 [MIT 许可证](.\u002FLICENSE) 开源。\n\n## 🌟 星标历史\n\n如果您觉得这个项目很有用，请考虑给它点个星！您的支持将帮助我们持续改进 Universal DB MCP。\n\n[![星标历史图](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FAnarkh-Lee_universal-db-mcp_readme_9d489e138f1d.png)](https:\u002F\u002Fstar-history.com\u002F#Anarkh-Lee\u002Funiversal-db-mcp&Date)\n\n## 📝 更改日志\n\n详细的版本历史请参阅 [CHANGELOG.md](.\u002FCHANGELOG.md)。\n\n---\n\n\u003Cp align=\"center\">\n 由 \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\">Anarkh-Lee\u003C\u002Fa> 用心打造 ❤️\n\u003C\u002Fp>","# Universal DB MCP 快速上手指南\n\nUniversal DB MCP 是一个基于模型上下文协议（MCP）和 HTTP API 的通用数据库连接器。它允许 AI 助手（如 Claude Desktop、Cursor、Dify 等）通过自然语言直接查询和分析您的数据库，无需编写 SQL。支持 MySQL、PostgreSQL、Oracle 及达梦、OceanBase 等 17 种国内外主流数据库。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n* **Node.js**: 版本需 >= 20.0.0。\n * 检查版本：`node -v`\n * 下载地址：[Node.js 官网](https:\u002F\u002Fnodejs.org\u002F) 或使用国内镜像源安装。\n* **npm**: Node.js 包管理器（随 Node.js 自动安装）。\n* **数据库访问权限**: 确保您拥有目标数据库的主机地址、端口、用户名、密码及数据库名称。\n* **AI 客户端**: 已安装支持 MCP 的客户端（如 Claude Desktop、Cursor、VS Code 等）或需要 HTTP 接口的平台（如 Dify）。\n\n> **提示**：国内开发者若遇到 npm 安装缓慢，可临时切换至淘宝镜像源：\n> ```bash\n> npm config set registry https:\u002F\u002Fregistry.npmmirror.com\n> ```\n\n## 安装步骤\n\n使用 npm 全局安装 `universal-db-mcp`：\n\n```bash\nnpm install -g universal-db-mcp\n```\n\n安装完成后，可通过以下命令验证安装是否成功：\n\n```bash\nnpx universal-db-mcp --help\n```\n\n## 基本使用\n\nUniversal DB MCP 提供两种主要运行模式：**MCP 模式**（用于本地 AI 编辑器\u002F桌面端）和 **HTTP API 模式**（用于远程服务或低代码平台）。\n\n### 模式一：MCP 模式（推荐用于 Claude Desktop \u002F Cursor）\n\n此模式允许您在本地 AI 工具中直接通过自然语言对话操作数据库。\n\n1. **配置客户端**\n 找到并编辑您的 AI 客户端配置文件。\n * **macOS**: `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n * **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n * **Cursor\u002FVS Code**: 在对应的 MCP 设置界面中添加以下配置。\n\n2. **添加服务器配置**\n 将以下内容添加到配置文件的 `mcpServers` 对象中（以 MySQL 为例）：\n\n ```json\n {\n \"mcpServers\": {\n \"my-database\": {\n \"command\": \"npx\",\n \"args\": [\n \"universal-db-mcp\",\n \"--type\", \"mysql\",\n \"--host\", \"localhost\",\n \"--port\", \"3306\",\n \"--user\", \"root\",\n \"--password\", \"your_password\",\n \"--database\", \"your_database\"\n ]\n }\n }\n }\n ```\n *请将 `your_password` 和 `your_database` 替换为实际信息。如需连接其他数据库（如 PostgreSQL、达梦等），修改 `--type` 参数即可。*\n\n3. **开始使用**\n 重启 AI 客户端，然后在对话框中输入自然语言指令，例如：\n * *\"显示 users 表的结构\"*\n * *\"统计过去 7 天的订单数量\"*\n * *\"找出销售额最高的前 5 个产品\"*\n\n### 模式二：HTTP API 模式（推荐用于 Dify \u002F 远程调用）\n\n此模式启动一个 HTTP 服务器，提供 REST API 和 MCP over SSE\u002FStreamable HTTP 接口。\n\n1. **设置环境变量**\n 在终端中设置运行模式、端口及 API 密钥：\n\n ```bash\n # Linux\u002FMac\n export MODE=http\n export HTTP_PORT=3000\n export API_KEYS=your-secret-key\n\n # Windows (PowerShell)\n $env:MODE=\"http\"\n $env:HTTP_PORT=\"3000\"\n $env:API_KEYS=\"your-secret-key\"\n ```\n\n2. **启动服务**\n 运行以下命令启动服务器：\n\n ```bash\n npx universal-db-mcp\n ```\n\n3. **测试连接**\n 使用 curl 测试服务是否正常运行：\n\n ```bash\n curl http:\u002F\u002Flocalhost:3000\u002Fapi\u002Fhealth\n ```\n\n4. **集成示例**\n * **Dify 等平台**: 使用 SSE 端点 `http:\u002F\u002Flocalhost:3000\u002Fsse?type=mysql&host=...` 或推荐的 Streamable HTTP 端点 `POST http:\u002F\u002Flocalhost:3000\u002Fmcp` 进行连接。\n * **自定义开发**: 直接调用 `\u002Fapi\u002Fquery` 或 `\u002Fapi\u002Fschema` 等 REST 接口。\n\n> **安全提示**：默认情况下，Universal DB MCP 运行在 **只读模式 (`safe`)**，禁止执行 INSERT、UPDATE、DELETE 等写操作以保护数据安全。如需写入权限，请在启动参数中显式配置 `--permissions`。","某电商公司的数据分析师需要在晨会前快速从包含 500 多张表的 PostgreSQL 生产库中，提取上月复购率最高的用户群体特征，以便向产品团队汇报。\n\n### 没有 universal-db-mcp 时\n- **沟通成本高**：分析师不懂复杂 SQL，需向后端工程师提需求并排队等待，往往错过晨会汇报时机。\n- **查询效率低**：面对庞大的数据库架构，手动编写关联查询语句耗时极长，仅加载表结构元数据就可能需要近一分钟。\n- **安全风险大**：直接赋予分析师写权限可能导致误操作删改数据，而只读账号又限制了临时深度分析的能力。\n- **工具切换繁琐**：需要在数据库客户端、Excel 和汇报文档间反复复制粘贴数据，容易出错且打断思路。\n\n### 使用 universal-db-mcp 后\n- **自然语言交互**：分析师直接在 Cursor 或 Claude Desktop 中输入“找出上月复购率最高的用户画像”，universal-db-mcp 自动将其转化为精准 SQL 并返回结果。\n- **极速响应体验**：得益于智能缓存和批量优化，即使面对 500 张表的大库，schema 检索速度也提升了 100 倍，秒级获取分析数据。\n- **默认安全隔离**：universal-db-mcp 默认开启只读模式并自动掩码手机号等敏感信息，让非技术人员也能安全地自助探索数据。\n- **工作流无缝融合**：分析结果直接呈现在代码编辑器或对话窗口中，可一键生成可视化图表或 Markdown 报告，无需切换上下文。\n\nuniversal-db-mcp 将原本需要跨部门协作数小时的数据提取任务，转变为个人几分钟内完成的自然语言对话，真正实现了数据民主化。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FAnarkh-Lee_universal-db-mcp_2620e962.png","Anarkh-Lee",null,"https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FAnarkh-Lee_49d247a9.jpg","https:\u002F\u002Fgithub.com\u002FAnarkh-Lee",[78,82,86,90],{"name":79,"color":80,"percentage":81},"TypeScript","#3178c6",88.4,{"name":83,"color":84,"percentage":85},"JavaScript","#f1e05a",10.3,{"name":87,"color":88,"percentage":89},"Batchfile","#C1F12E",1,{"name":91,"color":92,"percentage":93},"Dockerfile","#384d54",0.3,719,63,"2026-04-05T15:32:43","MIT","Linux, macOS, Windows","未说明",{"notes":101,"python":99,"dependencies":102},"该工具基于 Node.js 运行，非 Python 项目。默认以只读模式运行以确保安全。支持通过 stdio 或 HTTP 两种模式启动，可集成于 Claude Desktop、Cursor、Dify 等 50+ 平台。支持 MySQL、PostgreSQL、Oracle 等 17 种数据库（含多种国产数据库）。",[103,104],"node>=20.0.0","npm",[16,13,106],"插件","2026-03-27T02:49:30.150509","2026-04-07T00:51:50.511684",[110,115,120,125,130,135,140],{"id":111,"question_zh":112,"answer_zh":113,"source_url":114},20500,"连接达梦数据库（DM）失败或报“用户名密码错误”怎么办？","这是由于 dmdb 驱动在接收对象配置 {host, port...} 时存在解析 Bug，会将地址错误解析为 IPv6 localhost。解决方案是将配置改为连接字符串格式。代码修改示例如下：\nconst encodedPassword = encodeURIComponent(this.config.password);\nconst connectionString = `dm:\u002F\u002F${this.config.user}:${encodedPassword}@${this.config.host}:${this.config.port || 5236}\u002F${this.config.database}?loginEncrypt=false&cipherPath=''`;\nawait DM.getConnection(connectionString);\n注意：当前版本主要适配达梦 DM8，DM7 可能存在兼容性风险。","https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\u002Funiversal-db-mcp\u002Fissues\u002F18",{"id":116,"question_zh":117,"answer_zh":118,"source_url":119},20501,"使用 Claude Code 或 Cursor 时报错 'Can't add new command when connection is in closed state' 如何解决？","该问题是由于连接超时关闭导致的。已在 v2.11.0 版本中通过以下机制彻底解决：\n1. 连接池化：MySQL\u002FPG\u002FOracle 等适配器升级为连接池（如 MySQL 配置 enableKeepAlive + connectionLimit: 3）。\n2. 心跳保活：达梦适配器增加 30 秒定时心跳。\n3. 断线重试：所有网络适配器新增 withRetry 机制，断开后自动重试一次。\n4. TCP Keep-Alive：启用底层 TCP 保活防止中间件超时。\n请升级至 v2.11.0 或更高版本即可自动修复，无需手动重连。","https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\u002Funiversal-db-mcp\u002Fissues\u002F15",{"id":121,"question_zh":122,"answer_zh":123,"source_url":124},20502,"启动 SQLite 数据库时指定 --file-path 参数报错怎么办？","这是文档中的参数名称错误。正确的命令行参数应为 --file 而不是 --file-path。\n请使用以下格式启动：\nuniversal-db-mcp --type sqlite --file \u002Fpath\u002Fto\u002Fyour\u002Fdatabase.db\n维护者已在 v2.10.1 版本中修正了相关文档。","https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\u002Funiversal-db-mcp\u002Fissues\u002F11",{"id":126,"question_zh":127,"answer_zh":128,"source_url":129},20503,"能否让 AI 动态连接数据库，而不是在 MCP 配置文件中写死连接信息？","支持动态连接，有两种方式：\n1. HTTP 模式（推荐）：启动 HTTP 服务后，可通过 POST \u002Fapi\u002Fconnect 或在 URL 参数中动态传入数据库类型、地址、端口等信息，无需重启。\n2. MCP stdio 模式：从 v2.14.0 版本开始，已支持在 stdio 模式下进行动态数据库连接。你可以让 AI 通过对话调用 connect 或 switch_database 工具来动态建立连接，无需预先在配置文件中写死参数。","https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\u002Funiversal-db-mcp\u002Fissues\u002F19",{"id":131,"question_zh":132,"answer_zh":133,"source_url":134},20504,"数据库中包含图片、视频等媒体文件的路径，大模型能直接显示这些资源吗？","目前暂时不支持直接显示。当查询返回媒体路径（如 '\u002Fuploads\u002Favatar\u002F1.jpg'）时，大模型只能收到字符串路径，无法自动读取文件或渲染图片内容。\n未来计划支持 MCP Resources 协议来实现此功能，但目前需要用户自行处理路径到实际资源的映射和展示。","https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\u002Funiversal-db-mcp\u002Fissues\u002F7",{"id":136,"question_zh":137,"answer_zh":138,"source_url":139},20505,"PostgreSQL 数据库中 get_table_info 无法获取非 public schema 的表信息怎么办？","默认情况下工具可能只查询 public schema。若需获取其他 schema 的表信息，请在连接配置或查询指令中明确指定 schema 名称，或者检查是否需要在工具调用参数中传入 target_schema 字段。（注：具体实现需参考最新版本的 schema 扫描逻辑，通常需在连接串或工具参数中限定搜索范围）。","https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\u002Funiversal-db-mcp\u002Fissues\u002F17",{"id":141,"question_zh":142,"answer_zh":143,"source_url":144},20506,"Oracle 数据库连接时报 '--type 参数错误' 是怎么回事？","这通常是配置文件或启动命令中 --type 参数拼写错误或值不匹配导致的。请确保 --type 的值严格对应支持的数据库类型标识（例如 'oracle'），并检查大小写敏感性。维护者测试表明，只要参数正确，Oracle 连接功能正常。","https:\u002F\u002Fgithub.com\u002FAnarkh-Lee\u002Funiversal-db-mcp\u002Fissues\u002F21",[146,151,156,161,166,171,176,181,186,191,196,201,206,211,216,221,226,231,236,241],{"id":147,"version":148,"summary_zh":149,"released_at":150},126461,"v2.14.0","## [2.14.0] - 2026\n\n### 新增\n\n- **MCP stdio 模式动态数据库连接** - 支持在对话中动态连接\u002F切换数据库，无需写死配置\n - **新增 3 个 MCP Tool**：\n - `connect_database`：动态连接数据库，支持全部 17 种数据库类型，已有连接时自动断开旧连接\n - `disconnect_database`：断开当前数据库连接\n - `get_connection_status`：查看当前连接状态（类型、地址、权限模式、缓存状态）\n - **`--type` 参数改为可选**：不指定则以无连接模式启动，等待 AI 通过 `connect_database` 动态连接\n - **零配置启动**：`claude_desktop_config.json` 中只需 `\"args\": [\"universal-db-mcp\"]`，对话中告诉 AI 数据库信息即可\n - **向后兼容**：传了 `--type` 参数的用户行为完全不变\n - **影响范围**：仅 MCP stdio 模式，HTTP\u002FSSE\u002FStreamable HTTP 模式不受影响\n - **改动文件**：`src\u002Fmcp\u002Fmcp-server.ts`、`src\u002Fmcp\u002Fmcp-index.ts`\n\n#### 用户使用指南\n\n**方式 A：零配置启动（新增能力）**\n\n在 `claude_desktop_config.json` 中无需指定数据库参数：\n\n```json\n{\n \"mcpServers\": {\n \"universal-db\": {\n \"command\": \"npx\",\n \"args\": [\"universal-db-mcp\"]\n }\n }\n}\n```\n\n然后在对话中直接告诉 AI 数据库信息：\n\n- “帮我连接 192.168.1.100 的 MySQL，用户名 root，密码 123456，数据库 order_db”\n- “切换到 10.0.0.5 的 PostgreSQL，端口 5432，数据库 analytics”\n- “断开当前数据库连接”\n- “当前连的是哪个库？”\n\nAI 会自动调用 `connect_database`、`disconnect_database`、`get_connection_status` 工具。\n\n**方式 B：带默认连接启动（向后兼容，行为不变）**\n\n```json\n{\n \"mcpServers\": {\n \"universal-db\": {\n \"command\": \"npx\",\n \"args\": [\n \"universal-db-mcp\",\n \"--type\", \"mysql\",\n \"--host\", \"localhost\",\n \"--port\", \"3306\",\n \"--user\", \"root\",\n \"--password\", \"your_password\",\n \"--database\", \"your_database\"\n ]\n }\n }\n}\n```\n\n启动时自动连接指定数据库，对话中仍可通过 `connect_database` 切换到其他数据库。","2026-03-17T08:36:01",{"id":152,"version":153,"summary_zh":154,"released_at":155},126462,"v2.13.0","## [2.13.0] - 2026\n\n### 修复\n\n- **stdio 进程优雅退出** - 修复 stdio MCP 服务器在客户端（如 Codex CLI）关闭会话后进程挂起的问题\n - **问题表现**：Codex CLI 执行 `\u002Fexit` 后终端提示符不返回，必须手动 `Ctrl+C`\n - **根因**：未监听 `process.stdin` 的 `end`\u002F`close` 事件；`stop()` 方法未调用 `server.close()` 释放 transport 资源\n - **修复方案**：\n - `mcp-server.ts`：`stop()` 中新增 `server.close()` 调用，释放 stdin\u002Fstdout 监听器\n - `mcp-index.ts`：新增统一 `gracefulShutdown()` 函数，监听 `SIGINT`\u002F`SIGTERM`\u002F`stdin end`\u002F`stdin close`\n - 防重入保护（`shuttingDown` 标志）+ 5 秒超时兜底\n - **影响范围**：stdio 模式直接修复；SSE\u002FStreamable HTTP 模式间接受益（`cleanupSession()` 调用的 `stop()` 现在正确关闭 MCP 服务器）","2026-03-17T02:08:00",{"id":157,"version":158,"summary_zh":159,"released_at":160},126463,"v2.12.0","\u003Chtml>\n\u003Cbody>\n\u003C!--StartFragment-->\u003C!DOCTYPE html>\u003Ch2 cid=\"n3\" mdtype=\"heading\" class=\"md-end-block md-heading\" style=\"box-sizing: border-box; break-after: avoid-page; break-inside: avoid; orphans: 2; font-size: 1.75em; margin-top: 1rem; margin-bottom: 1rem; position: relative; font-weight: bold; line-height: 1.225; cursor: text; padding-bottom: 0.3em; border-bottom: 1px solid rgb(238, 238, 238); white-space: pre-wrap; color: rgb(51, 51, 51); font-family: "Open Sans", "Clear Sans", "Helvetica Neue", Helvetica, Arial, sans-serif; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;\">\u003Cspan md-inline=\"plain\" class=\"md-plain\" style=\"box-sizing: border-box;\">[2.12.0] - 2026\u003C\u002Fspan>\u003C\u002Fh2>\u003Ch3 cid=\"n4\" mdtype=\"heading\" class=\"md-end-block md-heading\" style=\"box-sizing: border-box; break-after: avoid-page; break-inside: avoid; orphans: 2; font-size: 1.5em; margin-top: 1rem; margin-bottom: 1rem; position: relative; font-weight: bold; line-height: 1.43; cursor: text; white-space: pre-wrap; color: rgb(51, 51, 51); font-family: "Open Sans", "Clear Sans", "Helvetica Neue", Helvetica, Arial, sans-serif; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;\">\u003Cspan md-inline=\"plain\" class=\"md-plain\" style=\"box-sizing: border-box;\">修复\u003C\u002Fspan>\u003C\u002Fh3>\u003Cul class=\"ul-list\" cid=\"n5\" mdtype=\"list\" data-mark=\"-\" style=\"box-sizing: border-box; margin: 0.8em 0px; padding-left: 30px; position: relative; color: rgb(51, 51, 51); font-family: "Open Sans", "Clear Sans", "Helvetica Neue", Helvetica, Arial, sans-serif; font-size: 16px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;\">\u003Cli class=\"md-list-item\" cid=\"n6\" mdtype=\"list_item\" style=\"box-sizing: border-box; margin: 0px; position: relative;\">\u003Cp cid=\"n7\" mdtype=\"paragraph\" class=\"md-end-block md-p\" style=\"box-sizing: border-box; line-height: inherit; orphans: 4; margin: 0px 0px 0.5rem; white-space: pre-wrap; position: relative;\">\u003Cspan md-inline=\"strong\" class=\"\" style=\"box-sizing: border-box;\">\u003Cstrong style=\"box-sizing: border-box;\">\u003Cspan md-inline=\"plain\" class=\"md-plain\" style=\"box-sizing: border-box;\">多 Schema 支持\u003C\u002Fspan>\u003C\u002Fstrong>\u003C\u002Fspan>\u003Cspan md-inline=\"plain\" class=\"md-plain\" style=\"box-sizin","2026-03-16T13:41:37",{"id":162,"version":163,"summary_zh":164,"released_at":165},126464,"v2.11.0","## [2.11.0] - 2026\n\n### 改进\n\n- **连接稳定性增强** - 全面升级数据库连接管理，彻底解决 `Can't add new command when connection is in closed state` 错误\n - **连接池化** - 12 个网络数据库适配器从单连接升级为连接池\n - MySQL 系列（MySQL、TiDB、OceanBase、PolarDB、GoldenDB）：使用 `mysql2` 连接池，配置 `enableKeepAlive` + `connectionLimit: 3`\n - PostgreSQL 系列（PostgreSQL、KingbaseES、GaussDB、Vastbase、HighGo）：使用 `pg.Pool`，配置 `keepAlive` + `max: 3`\n - Oracle：使用 `oracledb.createPool()`，配置 `poolPingInterval: 30`\n - **心跳保活** - 达梦适配器使用定时心跳（30 秒间隔）保持连接活跃\n - **断线自动重试** - 所有网络数据库适配器新增 `withRetry` 机制，连接断开后自动重试一次\n - **TCP Keep-Alive** - 所有连接池启用 TCP Keep-Alive，防止连接被服务端或中间件超时关闭\n- 不需要修改的适配器（已有内置机制）：SQL Server（连接池）、Redis（自动重连）、MongoDB（内置连接池）、SQLite（本地文件）、ClickHouse（HTTP 协议）","2026-03-12T07:27:26",{"id":167,"version":168,"summary_zh":169,"released_at":170},126465,"v2.10.1","修改文档中SQLite错误的参数信息 \n--file-path修改为--file","2026-03-10T14:19:45",{"id":172,"version":173,"summary_zh":174,"released_at":175},126466,"v2.10.0","## [2.10.0] - 2026\n\n### 新增\n\n- **细粒度权限控制** - 支持自定义操作权限组合，不再只有“只读”和“完全写入”两种模式\n - **权限模式** - 新增 `--permission-mode` 参数\n - `safe`（默认）：只读模式，仅允许 SELECT\n - `readwrite`：读写模式，允许 SELECT\u002FINSERT\u002FUPDATE，禁止 DELETE 和 DDL\n - `full`：完全控制，等价于原来的 `--danger-allow-write`\n - `custom`：自定义模式，配合 `--permissions` 使用\n - **自定义权限** - 新增 `--permissions` 参数，支持逗号分隔的权限列表\n - `read`：SELECT 查询（始终包含）\n - `insert`：INSERT, REPLACE\n - `update`：UPDATE\n - `delete`：DELETE, TRUNCATE\n - `ddl`：CREATE, ALTER, DROP, RENAME\n - **向后兼容** - `--danger-allow-write` 仍然有效，等价于 `--permission-mode=full`\n - **HTTP API 支持** - REST API 和 MCP SSE\u002FStreamable HTTP 端点同样支持新权限参数\n\n### 改进\n\n- 更新 `DbConfig` 类型，新增 `permissionMode` 和 `permissions` 字段\n- 重构 `safety.ts`，支持细粒度权限检查\n- 更新命令行帮助信息，添加新参数说明\n- 更新 README 文档（中英文），添加权限模式说明\n\n### 文档\n\n- **完善权限配置文档** - 添加不同传输方式的权限参数命名说明\n - STDIO 模式（Claude Desktop）：使用连字符命名 `--permission-mode`、`--permissions`\n - SSE 模式（Dify 等）：使用驼峰命名 `permissionMode`、`permissions`（URL Query）\n - Streamable HTTP 模式：使用连字符命名 `X-DB-Permission-Mode`、`X-DB-Permissions`（HTTP Header）\n - REST API 模式：使用驼峰命名 `permissionMode`、`permissions`（JSON Body）","2026-02-12T01:43:16",{"id":177,"version":178,"summary_zh":179,"released_at":180},126467,"v2.9.0","## [2.9.0] - 2026\n\n### 新增\n- **按需增强工具** - 新增两个 MCP 工具，帮助 LLM 更好地理解数据内容\n - **`get_enum_values`** - 获取指定列的所有唯一值\n - 适用于枚举类型列、状态列等有限值集合\n - 支持 limit 参数控制返回数量\n - 返回值包含 `isComplete` 标识是否返回了全部值\n - **`get_sample_data`** - 获取表的示例数据\n - 自动数据脱敏，保护敏感信息（手机号、邮箱、身份证、银行卡等）\n - 支持按列名模式匹配和按值格式自动检测两种脱敏方式\n - 可通过 `masking` 参数控制是否启用脱敏\n- **数据脱敏工具** - 新增 `DataMasker` 工具类（`src\u002Futils\u002Fdata-masking.ts`）\n - 支持 7 种脱敏类型：phone、email、idcard、bankcard、password、partial、full\n - 支持自定义脱敏规则\n - 自动检测敏感数据格式\n- **REST API 端点** - 新增两个 HTTP API 端点\n - `GET \u002Fapi\u002Fenum-values` - 获取枚举值\n - `GET \u002Fapi\u002Fsample-data` - 获取示例数据\n\n### 改进\n- 新增 `EnumValuesResult` 和 `SampleDataResult` 类型定义\n- 更新 API 参考文档（中英文），添加新端点说明\n- 新增 20 个数据脱敏单元测试\n","2026-02-07T08:45:56",{"id":182,"version":183,"summary_zh":184,"released_at":185},126468,"v2.8.0","## [2.8.0] - 2026\n\n### 新增\n- **Schema 核心增强** - 提升 LLM 对数据库结构的理解，提高 Text2SQL 准确性\n - **表注释支持** - Schema 信息现在包含表级别注释（`comment` 字段）\n - 支持的数据库：MySQL、PostgreSQL、Oracle、SQL Server、TiDB、达梦、KingbaseES、GaussDB、OceanBase、PolarDB、Vastbase、HighGo、GoldenDB、ClickHouse（14个）\n - 不支持：Redis、MongoDB（NoSQL）、SQLite（无原生表注释）\n - **隐式关系推断** - 基于列命名规则自动推断表间关系\n - 支持模式：`xxx_id` → `xxxs.id`、`xxxId` → `xxxs.id`（驼峰）、`xxx_code` → `xxxs.code`、`xxx_no` → `xxxs.xxx_no`\n - 推断规则：不覆盖显式外键、验证目标表存在、验证目标列存在\n - 置信度评分：0.7-0.95，LLM 可根据置信度判断关系可靠性\n - **关系类型细化** - 通过检查唯一约束区分 `one-to-one` 和 `many-to-one`\n - **关系来源标注** - `source` 字段区分 `foreign_key`（显式外键）和 `inferred`（推断关系）\n\n### 改进\n- 新增 `SchemaEnhancer` 工具类（`src\u002Futils\u002Fschema-enhancer.ts`）\n- 更新 `RelationshipInfo` 类型，添加 `source` 和 `confidence` 字段\n- 更新 `TableInfo` 类型，添加 `comment` 字段\n- 更新 14 个数据库适配器，添加表注释查询支持","2026-02-06T05:36:07",{"id":187,"version":188,"summary_zh":189,"released_at":190},126469,"v2.7.0","**外键关系支持** - 模式信息 now 包含外键和表关系数据，帮助 LLM 更好地理解数据库结构\n\n- `foreignKeys` - 表级别的外键约束信息，包含约束名、列、引用表、引用列、ON DELETE\u002FUPDATE 规则\n- `relationships` - 全局关系视图，展示所有表之间的关联关系\n- 支持的数据库：MySQL、PostgreSQL、Oracle、SQL Server、SQLite、达梦、KingbaseES、GaussDB、OceanBase、TiDB、PolarDB、Vastbase、HighGo、GoldenDB\n- NoSQL 数据库（Redis、MongoDB、ClickHouse）不支持传统外键，返回结果中不包含这些字段","2026-02-05T15:29:40",{"id":192,"version":193,"summary_zh":194,"released_at":195},126470,"v2.6.1","更新文档","2026-02-03T08:57:26",{"id":197,"version":198,"summary_zh":199,"released_at":200},126471,"v2.6.0","### 新增\r\n\r\n- **MCP SSE\u002FStreamable HTTP 传输支持** - 在 HTTP 模式下新增 MCP 协议端点\r\n - `\u002Fsse` - SSE 传输端点（传统方式），支持通过 URL 参数配置数据库连接\r\n - `\u002Fsse\u002Fmessage` - SSE 消息接收端点\r\n - `\u002Fmcp` (POST) - Streamable HTTP 端点（MCP 2025 规范，推荐），支持通过请求头配置数据库连接\r\n - `\u002Fmcp` (GET) - Streamable HTTP 的 SSE 流端点\r\n - `\u002Fmcp` (DELETE) - 关闭会话端点\r\n- Dify 等平台现在可以直接通过 MCP 协议连接，无需使用自定义 API 工具\r\n- 灵活架构：2 种启动模式（stdio\u002Fhttp），4 种接入方式（MCP stdio、MCP SSE、MCP Streamable HTTP、REST API）\r\n- **统一 API Key 认证** - MCP SSE\u002FStreamable HTTP 端点现在也支持 API Key 认证，与 REST API 保持一致","2026-02-02T13:17:22",{"id":202,"version":203,"summary_zh":204,"released_at":205},126472,"v2.5.0","Oracle 11g 需要使用 Thick 模式，添加 `--oracle-client-path` 参数：\r\n\r\n```json\r\n{\r\n \"mcpServers\": {\r\n \"oracle-11g\": {\r\n \"command\": \"npx\",\r\n \"args\": [\r\n \"universal-db-mcp\",\r\n \"--type\", \"oracle\",\r\n \"--host\", \"localhost\",\r\n \"--port\", \"1521\",\r\n \"--user\", \"system\",\r\n \"--password\", \"your_password\",\r\n \"--database\", \"ORCL\",\r\n \"--oracle-client-path\", \"\u002Fopt\u002Foracle\u002Finstantclient_19_8\"\r\n ]\r\n }\r\n }\r\n}\r\n```\r\n","2026-01-30T08:31:46",{"id":207,"version":208,"summary_zh":209,"released_at":210},126473,"v2.4.0","重构文档","2026-01-30T07:14:29",{"id":212,"version":213,"summary_zh":214,"released_at":215},126474,"v2.3.8","bugfix：Oracle、达梦执行sql去掉分号","2026-01-29T08:57:43",{"id":217,"version":218,"summary_zh":219,"released_at":220},126475,"v2.3.7","bugfix：达梦get_schema问题5","2026-01-29T08:35:05",{"id":222,"version":223,"summary_zh":224,"released_at":225},126476,"v2.3.6","bugfix：达梦get_schema问题4","2026-01-29T08:17:07",{"id":227,"version":228,"summary_zh":229,"released_at":230},126477,"v2.3.5","bugfix：达梦get_schema问题3","2026-01-29T08:02:17",{"id":232,"version":233,"summary_zh":234,"released_at":235},126478,"v2.3.4","bugfix：达梦get_schema问题2","2026-01-29T07:45:03",{"id":237,"version":238,"summary_zh":239,"released_at":240},126479,"v2.3.3","bugfix：达梦get_schema问题，达梦不使用批量查询优化功能","2026-01-29T07:35:44",{"id":242,"version":243,"summary_zh":244,"released_at":245},126480,"v2.3.2","bugfix：达梦get_schema返回table为空问题处理","2026-01-29T07:20:29"]