GitHub开源推荐:这3个MCP插件让Claude Code直接操作数据库和API
前言:你的Claude Code还在“裸奔”吗?
如果你还在让Claude Code只做代码补全和文件编辑,那你可能只用了它10%的能力。
2026年的AI编程助手早已不是那个“只会写代码的聊天机器人”了。根据MCP生态统计,截至2026年2月,已公开超过9,000个Claude Code插件,生态系统持续高速扩展。而这一切的核心,就是 MCP(Model Context Protocol,模型上下文协议) ——Anthropic于2024年底发布的开源标准,旨在以结构化、可靠的方式将AI模型连接到外部工具和数据源。
简单说:没有MCP,Claude Code只能操作本地文件;装了对的MCP,它能帮你完成整个开发流程。
但问题来了:面对1000多个MCP服务器,到底装哪些最实用?
今天这篇文章,我亲自踩坑、实测,给大家推荐3个让Claude Code直接操作数据库和API的开源MCP插件。从MySQL到PostgreSQL,再到GitHub和通用REST API——装上它们,你的Claude Code从此不再是“本地编辑器”,而是全栈开发搭档。
一、MCP是什么?为什么它正在改变AI编程
在深入插件之前,先花30秒理解MCP的本质。
MCP是一个开放标准,让LLM能够调用外部工具和数据。它定义了AI助手如何发现、调用和交互外部服务——数据库、API、浏览器、GitHub,统统不在话下。
用更直白的话说:MCP就是AI的“USB-C接口” 。任何遵循这个协议的工具,都能即插即用地接入Claude Code。
根据2026年5月发布的MCP CLI v0.3.0,MCP生态已经引入了增强的连接池、工具过滤能力,以及简化的3子命令架构,大幅降低了服务器管理和工具调用的复杂度。
目前主流的配置方式是通过 ~/.claude/.mcp.json 文件(用户级配置),也可以在项目根目录放置 .mcp.json 实现项目级配置。
关键句: 一个
mcp.json配置文件,就能让Claude Code拥有操作数据库、调用API、管理GitHub的全套能力。
二、插件1:mcp-mysql-server —— 让Claude Code直连MySQL
2.1 解决什么问题?
作为后端开发,最痛苦的莫过于:在IDE和数据库客户端之间反复横跳。写代码时想查一下表结构→切到Navicat→敲SQL→复制结果→切回IDE。一次两次还好,一天几十次简直要命。
mcp-mysql-server 彻底解决了这个问题。它基于 @modelcontextprotocol/sdk + mysql2 构建,让Claude Code直接用自然语言操作MySQL数据库。
该项目由社区开发者 @huangcaiming5913 维护,2026年6月8日发布了1.2.0版本。
2.2 架构设计
这个MCP服务器的架构非常清晰:
Claude Code ←→ stdio ←→ MCP Server (Node.js) ←→ MySQL Connector ←→ MySQL数据库
- 传输层:通过stdio与Claude Code通信
- 连接管理:支持多环境配置(dev/staging/production),通过
profiles.yml管理 - 安全层:默认只读模式,可选的DDL权限控制
2.3 安装与配置(手把手教程)
第一步:克隆与安装
git clone <repo-url> && cd mcp-mysql-server
npm install && npm run build
第二步:配置数据库连接
创建 ~/.mcp-mysql/profiles.yml(推荐,支持多环境切换):
default: dev
profiles:
dev:
host: 127.0.0.1
port: 3306
user: root
password: "your_password"
database: my_app
readonly: true
staging:
host: 192.168.1.100
user: readonly
password: "staging_password"
database: my_app
如果没有 profiles.yml,也可以通过环境变量配置单连接。
第三步:注册到Claude Code
# 用户级别注册(所有项目可用)
claude mcp add mysql node /absolute/path/to/mcp-mysql-server/dist/index.js -s user
# 或使用npx(已发布到npm时)
claude mcp add mysql npx @huangcaiming5913/mcp-mysql-server -s user
手动配置方式(编辑 ~/.claude/.mcp.json):
{
"mcpServers": {
"mysql": {
"command": "node",
"args": ["/absolute/path/to/mcp-mysql-server/dist/index.js"]
}
}
}
第四步:重启Claude Code,开始使用
2.4 功能全景:11个工具任你调用
这个插件提供了11个工具,覆盖了数据库操作的方方面面:
| 工具名 | 用途 |
|---|---|
list_profiles |
列出所有数据库配置(脱敏,不含密码) |
use_profile |
切换数据库连接(验证连通性后才切换) |
current_profile |
查看当前使用的数据库连接 |
query |
执行SQL(受安全策略控制) |
list_databases |
列出可访问的数据库 |
list_tables |
列出表及行数、引擎、注释 |
describe_table |
查看字段定义和索引 |
explain_query |
执行计划分析 + 优化建议 |
generate_schema_doc |
生成Markdown表结构文档 |
analyze_relations |
分析表间关系(外键 + 索引推断) |
table_stats |
表数据量、存储大小、更新时间 |
2.5 实际使用演示
配置完成后,你可以直接在Claude Code中用自然语言操作数据库:
你:看下有哪些数据库
Claude:[调用list_databases] 当前可访问的数据库有:my_app, test_db, analytics...
你:dst_goods里有什么表
Claude:[调用list_tables] dst_goods包含以下表:g_goods_manage (12,450行), g_category (89行)...
你:查一下上架中的商品有多少个
Claude:[调用query] SELECT COUNT(*) FROM g_goods_manage WHERE status='online' → 3,247个
你:切换到staging环境
Claude:[调用use_profile] 已切换到staging环境,连接验证通过
2.6 安全配置要点
根据官方文档,安全建议包括:
- 不要将
profiles.yml提交到代码仓库 - Unix/macOS执行
chmod 600 ~/.mcp-mysql/profiles.yml - Windows通过文件属性限制访问权限
- 默认
readonly: true,防止意外写入 maxRows默认1000行,防止大查询撑爆上下文
三、插件2:pg-mcp —— PostgreSQL的零配置MCP方案
3.1 为什么选择pg-mcp?
如果说MySQL有多个MCP方案可选,那PostgreSQL这边,pg-mcp 绝对是2026年最值得关注的一个。
由 @mir1198yusuf 开发,2026年4月18日发布。它的核心卖点就一句话:极简、本地、多数据库支持、自带UI。
关键句: 无需云服务、无需第三方——完全运行在你的本地机器上。
3.2 竞品对比:pg-mcp vs dbecho vs read-only-postgres
在PostgreSQL MCP领域,目前有几个主流选择。我做了一个对比:
| 特性 | pg-mcp | dbecho | read-only-postgres-mcp |
|---|---|---|---|
| 技术栈 | Node.js | Python | Node.js |
| 安装方式 | npm install -g | pip install | npm install |
| 多数据库支持 | ✅ | ✅ | ❌ |
| UI管理界面 | ✅ | ❌ | ❌ |
| 传输协议 | HTTP | stdio | stdio |
| 首次发布时间 | 2026-04-18 | 2026-06-04 | 2026-01-29 |
| 工具数量 | 2个核心工具 | 13个工具 | 基础查询 |
pg-mcp的优势在于极简——只有2个核心工具(list_dbs 和 query),但配合UI管理界面,上手体验极佳。相比之下,dbecho提供了更丰富的分析能力(趋势分析、异常检测、数据质量审计等),适合数据分析场景。
3.3 安装配置(含UI Dashboard)
第一步:全局安装
npm install @mir1198yusuf/pg-mcp -g
第二步:首次运行设置
pg-mcp
# 首次运行会询问:Port to run on (default: 3000):
# 配置保存到 ~/.pg-mcp/.env
第三步:通过UI添加数据库连接
打开浏览器访问 http://localhost:3000/ui,添加数据库连接信息。配置保存在 ~/.pg-mcp/dbs.json —— 永远留在本地,不会提交到任何地方。
第四步:注册到Claude Code
claude mcp add --transport http --scope local pgmcplocal http://localhost:3000/mcp
第五步:重启Claude Code,即可使用。
3.4 安全设计亮点
pg-mcp在安全方面做得非常到位:
- 只读强制:
INSERT、UPDATE、DELETE、DROP、CREATE、ALTER、TRUNCATE、GRANT、REVOKE、REPLACE、MERGE全部在到达数据库之前被拦截 - 凭证隔离:
~/.pg-mcp/dbs.json包含明文数据库凭证,绝不分享或提交 - 本地运行:不要在公网服务器上运行此MCP——它只应在本地机器上使用
- 动态可用性:如果某个数据库在启动时不可达,服务器仍然启动——Claude会被告知该数据库不可用
3.5 使用体验
配置完成后,Claude Code的工作流是这样的:
- Claude调用
list_dbs获取所有可用数据库列表 - 根据你的问题,选择合适的数据库
- 调用
query执行只读SQL - 返回JSON格式结果
UI面板还支持:
- 添加新的数据库连接
- 编辑已有连接(描述、凭证等)
- 重试失败的连接(无需重启服务器)
- 删除连接
- 每个数据库显示实时可用状态
四、插件3:GitHub MCP + OpenAPI MCP —— API操作双雄
4.1 GitHub MCP:让Claude成为你的自动PR机器人
如果说数据库操作是“读数据”,那GitHub操作就是“写协作”。GitHub MCP服务器让Claude Code直接连接GitHub API,通过自然语言管理整个GitHub工作流。
目前GitHub MCP有两个主流选择:
选择一:官方GitHub MCP
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "你的GitHub Token"
}
}
}
}
选择二:@noushad999/github-mcp-server(社区优化版)
这是一个更轻量的替代方案:
| 对比维度 | 社区优化版 | 官方版 |
|---|---|---|
| 安装 | npm install + token | Docker required |
| 响应大小 | ~320 tokens平均 | 2000+ tokens |
| Token效率 | Null剥离、紧凑化 | 原始JSON透传 |
| 缓存 | 120秒内存缓存 | 无缓存 |
| 工具数 | 19个 | ~30个 |
| 默认分支 | 自动检测 | 硬编码main |
安装命令:
GITHUB_TOKEN=ghp_your_token npx @noushad999/github-mcp-server
支持的权限范围:
| 权限 | 级别 | 用途 |
|---|---|---|
| Contents | Read & Write | 读取文件、创建分支、删除分支 |
| Issues | Read & Write | 列出、创建、分配、评论Issue |
| Pull requests | Read & Write | 列出、创建、合并PR、获取diff |
| Actions | Read & Write | 列出工作流、触发工作流 |
| Metadata | Read | 列出仓库、获取仓库信息 |
实际演示:
你:Merge PR #47 with squash, delete the branch, then create a release v2.1.0 with those changes
Claude:[调用3个API] 完成!PR已合并(squash),分支已删除,release v2.1.0已创建。
4.2 OpenAPI MCP:调用任意REST API的“万能钥匙”
如果说GitHub MCP解决的是“一个平台的API”,那 OpenAPI MCP 解决的是“所有平台的API”。
mcp-openapi-runner 可以把任何OpenAPI 3.x规范自动转换成MCP工具:
# 指向任意OpenAPI spec,Claude就能调用每个端点
mcp-openapi-runner https://api.example.com/openapi.json
工作原理:
- 一个REST端点映射到一个MCP工具
- 查询参数变成类型化的函数参数
- JSON响应直接流回Claude
这意味着:只要一个服务提供了OpenAPI规范,Claude Code就能立刻通过自然语言调用它的全部API——无需编写任何集成代码。
4.3 生态工具扩展:不只是GitHub
除了GitHub,MCP生态已经覆盖了几乎所有主流SaaS工具:
| 工具 | MCP服务器 | 发布时间 |
|---|---|---|
| Slack | Slack MCP Server | 2026 |
| Notion | notion-mcp-server | 2026-06-05 |
| Jira | jira-mcp-server | 2026-06-06 |
| Supabase | Supabase MCP | 2026-06-12 |
根据Composio的评测,“MCP集成插件将Claude Code连接到外部服务——当相关上下文在代码仓库之外时(Linear中的Issue、Slack中的告警、Vercel中的部署),这些插件非常有用”。
五、三款插件横向对比与选型建议
| 维度 | mcp-mysql-server | pg-mcp | GitHub/OpenAPI MCP |
|---|---|---|---|
| 目标场景 | MySQL数据库操作 | PostgreSQL数据库操作 | 代码协作平台 + 通用API |
| 安装复杂度 | 中等(需clone + build) | 低(npm install -g) | 低(npx一键) |
| 配置方式 | profiles.yml / 环境变量 | UI界面 / 环境变量 | GitHub Token / OpenAPI Spec |
| 安全机制 | 只读默认 + DDL可选 | 服务端强制只读 | Token权限控制 |
| 工具数量 | 11个 | 2个 | 19-30个 |
| 多环境支持 | ✅(dev/staging/prod) | ✅(多数据库) | ❌ |
| UI界面 | ❌ | ✅(http://localhost:3000/ui) | ❌ |
| 发布状态 | 1.2.0 (2026-06-08) | 1.0.0 (2026-04-18) | 持续更新 |
选型建议
如果你是MySQL用户 → 选 mcp-mysql-server,11个工具覆盖从查询到优化的全流程,多环境配置对微服务架构尤其友好。
如果你是PostgreSQL用户 → 选 pg-mcp,极简配置+UI管理,上手零门槛,多数据库支持让你同时管理多个项目的数据。
如果你需要GitHub自动化或调用第三方API → GitHub MCP + OpenAPI MCP组合拳,一个管代码协作,一个管API集成,覆盖面最广。
六、安全风险与部署方案深度剖析
6.1 安全风险:MCP不是“玩具”
MCP服务器让AI直接访问生产数据库和API,安全绝不能忽视。以下是几个核心风险点:
风险一:凭证泄露
profiles.yml 和 dbs.json 包含明文数据库凭证。千万不要提交到Git仓库。
风险二:SQL注入与数据篡改
虽然大部分MCP服务器默认只读,但并非全部。根据安全设计:
mcp-mysql-server:默认readonly: true,allowDdl默认falsepg-mcp:服务端强制拦截所有写操作,包括INSERT/UPDATE/DELETE/DROP/CREATE等@hovecapital/read-only-mysql-mcp-server:只允许SELECT语句
风险三:公网暴露
pg-mcp明确警告:“不要将此MCP服务器运行在公网服务器上——它只应在本地机器上运行。在VPS或任何公开可达的主机上运行,会将数据库暴露给任何能访问该端口的人”。
6.2 部署方案:本地 vs 远程
方案一:纯本地部署(推荐)
所有MCP服务器运行在开发者本地机器上,通过stdio或localhost HTTP与Claude Code通信。这是最安全的方案,数据库凭证不出本地。
方案二:远程MCP服务器
适用于团队共享场景。但需要注意:根据Glean在2026年5月的测试,远程MCP服务器在某些场景下表现优于本地方案——其系统在约175次查询中,被用户偏好的频率约为竞品的2.5倍。
方案三:企业级部署
对于企业场景,Claude Code在2026年5月8-9日的连续更新中,修复了MCP、代理、权限和模型网关相关的多个问题。建议企业用户:
- 使用项目级配置(
.mcp.json)而非用户级配置 - 通过GitHub Token的细粒度权限控制MCP可访问范围
- 对生产数据库使用只读副本,而非主库
七、MCP生态趋势与2026年展望
7.1 生态爆发式增长
2026年的MCP生态正在经历爆发式增长:
- 截至2026年2月,已公开超过9,000个插件
- MCP CLI v0.3.0 引入了连接池、工具过滤等企业级特性
- Anthropic在2026年1月发布了MCP Tool Search,这是社区长期期待的功能
7.2 三大趋势判断
趋势一:从“能用”到“好用”
早期的MCP服务器功能单一、配置复杂。2026年的新版本正在大幅降低使用门槛——pg-mcp的UI界面、claude mcp add 一键注册命令、mcp-openapi-runner的零配置都在印证这一趋势。
趋势二:从“单工具”到“工具箱”
像 mcp-saas-toolkit 这样的项目,在一个MCP服务器中集成了Stripe、Twilio、Resend、GitHub和Slack等24个工具。未来,一个MCP服务器覆盖一个完整的工作流将成为主流。
趋势三:安全成为核心竞争力
从只读默认到服务端强制拦截,从Token细粒度权限到列级脱敏和审计日志——安全能力正在成为MCP服务器选型的核心指标。
八、实践建议:从零搭建你的MCP工作流
第一步:评估需求
问自己三个问题:
- 我主要用什么数据库?(MySQL / PostgreSQL / 其他)
- 我需要操作GitHub吗?(Issue / PR / Release管理)
- 我需要调用第三方API吗?(有OpenAPI规范吗?)
第二步:最小化安装
不要一次性装10个MCP。根据测试,当可见工具超过约50个时,模型开始选错工具——因为所有工具描述都在上下文窗口中,选项越多,选择任务越嘈杂。
建议从 2-3个核心MCP 开始:
# MySQL用户
claude mcp add mysql npx @huangcaiming5913/mcp-mysql-server -s user
# PostgreSQL用户
npm install @mir1198yusuf/pg-mcp -g
pg-mcp # 首次设置
claude mcp add --transport http --scope local pgmcplocal http://localhost:3000/mcp
# GitHub用户
claude mcp add github npx @modelcontextprotocol/server-github -s user
第三步:配置安全策略
- 数据库连接使用只读账号,而非生产主账号
- GitHub Token使用细粒度权限,仅授予必要的最小权限集
- 配置文件设置 600权限(Unix/macOS)
- 绝不将含凭证的配置文件提交到Git
第四步:逐步扩展
熟练使用2-3个核心MCP后,再根据需求扩展:
- 需要网页搜索 → brave-search MCP
- 需要文件系统操作 → filesystem MCP
- 需要Slack/Notion/Jira集成 → 对应的MCP服务器
结语:MCP正在重新定义“全栈开发”
2026年的开发者,不再需要在IDE、数据库客户端、GitHub网页、API调试工具之间反复切换。
一个Claude Code + 3个MCP插件 = 一个能操作数据库、管理代码仓库、调用API的全栈开发环境。
这不是未来——这就是现在。
我的建议: 今天就装上这3个MCP插件,让Claude Code从“代码补全工具”升级为“全栈开发搭档”。你省下的每一个切换上下文的时间,都会变成实实在在的生产力。
你准备先装哪个?欢迎在评论区分享你的MCP使用体验!
本文所有项目信息均来自官方GitHub仓库、npm/pypi发布页及社区文档,发布日期和版本号已标注。建议在实际部署前查阅各项目的最新文档。
更多推荐

所有评论(0)