几个好用的MCP分享
下面是一个详细的 MCP(Model Context Protocol)服务器配置教程,适用于 Cursor、Claude Code 等支持 mcp.json(或类似 JSON 配置文件)格式的 AI 工具。内容涵盖原理、常用配置项、环境变量写法、常见用法和注意事项,并结合实际的配置举例说明。
MCP 配置教程(以 Cursor/Claude Code 为例)
1. MCP 原理简介
MCP(Model Context Protocol)是一种用于 AI 工具与外部服务(如数据库、API、浏览器自动化等)集成的协议。通过配置 mcp.json(或 .cursor/mcp.json),你可以让 AI 具备“调用外部工具”的能力,实现代码自动化、数据查询、网页操作等高级功能。
2. mcp.json 文件结构
mcp.json 是一个标准的 JSON 文件,通常位于用户主目录下的 .cursor
或 .claude
文件夹中。其核心结构如下:
{"mcpServers": {"服务别名": {"command": "启动命令","args": ["参数1", "参数2", ...],"env": { "环境变量名": "值", ... },"enabled": true},...}
}
- 服务别名:自定义,AI 工具通过别名调用该服务
- command:要执行的命令(如 npx、python、cmd.exe 等)
- args:命令行参数数组
- env:环境变量(可选,常用于数据库/API 密钥等)
- enabled:是否启用(可选,true/false)
3. 常见服务配置举例
3.1 MySQL 数据库 MCP
"mysql": {"command": "npx","args": ["-y","@benborla29/mcp-server-mysql"],"env": {"MYSQL_HOST": "192.168.100.151","MYSQL_PORT": "3003","MYSQL_USER": "root","MYSQL_PASS": "123456","MYSQL_DB": "ry-vue","ALLOW_INSERT_OPERATION": "true","ALLOW_UPDATE_OPERATION": "true","ALLOW_DELETE_OPERATION": "true"}
}
- 说明:通过 npx 启动 MySQL MCP 服务,env 里配置数据库连接参数和权限。
3.2 Postgres 数据库 MCP
"postgres": {"command": "C:\\Windows\\System32\\cmd.exe","args": ["/c","npx","-y","@modelcontextprotocol/server-postgres","postgresql://postgres:123456@localhost:5432/bladex"]
}
- 说明:通过 npx 启动 Postgres MCP 服务,连接字符串直接写在 args 里。
3.3 浏览器自动化(Playwright)
"playwright": {"command": "npx","args": ["-y", "@executeautomation/playwright-mcp-server"]
}
- 说明:用于网页自动化、页面抓取等。
3.4 Supabase(云)
"supabase": {"command": "C:\\Windows\\System32\\cmd.exe","args": ["/c","npx","-y","@supabase/mcp-server-supabase@latest","--access-token","你的supabase token"]
}
3.5 其它服务(如 Brave Search、上下文服务等)
"brave-search": {"command": "C:\\Windows\\System32\\cmd.exe","args": ["/c","npx","-y","@smithery/cli@latest","run","@smithery-ai/brave-search","--config","{\"braveApiKey\":\"123321\"}"]
}
4. 环境变量写法
- Windows 下推荐用
"env": { ... }
,如上 mysql 示例 - Linux/Mac 下也可用
"env": { ... }
- 不要在 args 里直接写 export/set,统一用 env 字段
5. 启用/禁用服务
"enabled": true
表示启用,省略则默认启用- 设置为 false 可临时关闭某个服务
6. 常见问题与注意事项
- 路径区分大小写,Windows 下注意转义和绝对路径
- npx 需已全局安装 Node.js
- 某些服务需要 API Key 或 Token,务必妥善保管
- 修改 mcp.json 后,建议重启 AI 工具以生效
- 某些服务(如数据库)需保证网络可达
7. 进阶:自定义服务
你可以集成任何支持命令行启动的服务,只需配置 command、args、env 即可。例如自定义 Python 脚本、Shell 工具等。
8. 参考你的实际配置(节选)
"mysql": {"command": "npx","args": ["-y","@benborla29/mcp-server-mysql"],"env": {"MYSQL_HOST": "192.168.100.151","MYSQL_PORT": "3003","MYSQL_USER": "root","MYSQL_PASS": "123456","MYSQL_DB": "ry-vue","ALLOW_INSERT_OPERATION": "true","ALLOW_UPDATE_OPERATION": "true","ALLOW_DELETE_OPERATION": "true","ALLOW_ALTER_OPERATION": "true","ALLOW_DROP_OPERATION": "true"}
}
9. 总结
- mcp.json 让 AI 工具具备“外部能力”,如数据库、网页、API 等
- 配置灵活,支持多种服务
- 推荐每次修改后重启工具,确保配置生效