🚀 AmzMCPDevTools
用于AI驱动开发的综合MCP(模型上下文协议)配置工具包
精心策划的MCP服务器配置、角色特定指南和工作流示例集合,通过强大的外部工具集成为您的AI编码助手(Cursor、VS Code Copilot)提供动力。
](./CHANGELOG.md)  
______________________________________________________________________
📋 目录
______________________________________________________________________
🎯 什么是MCP?
模型上下文协议(MCP) 是一种标准化协议,使Cursor和GitHub Copilot等AI助手能够与外部服务、数据库、API和工具进行交互。将其视为赋予你的人工智能超能力!
关键利益
- 🔌 扩展功能:访问数据库、浏览器、容器等
- 🎯 工作流集成:结合多种工具完成复杂任务
- 🚀 提高生产率:自动化重复性任务并简化开发
- 🔍 情境感知:AI了解您的整个开发环境
______________________________________________________________________
📦 包含内容
📚 综合文档
- 技术指南 (技术\_ GIDE.md):1000多条线路覆盖所有16台MCP服务器
- 角色特定指南:针对不同开发人员角色优化配置
- 工作流示例:8个真实世界的端到端场景
- 常见问题解答:回答了40+个常见问题
⚙️ 配置文件
- mcp.json:所有16台服务器的生产就绪配置
- mcp.json.模板:带有占位符的模板,用于团队共享
🛠️ 工具和脚本
- health-check.sh:验证您的MCP设置和依赖关系
- 自动检查配置、依赖关系和性能
🎓 学习资源
- Windows、macOS和Linux的分步设置
- 每个MCP服务器的故障排除指南
- 安全最佳实践和性能优化提示
______________________________________________________________________
⚡ 快速开始
1.克隆存储库
git clone https://github.com/AmzurATG/AmzMCPDevTools.git
cd AmzMCPDevTools2.选择你的道路
选项A:复制完整配置
# For Cursor
cp mcp.json ~/.cursor/mcp.json
# For VS Code (Linux)
cp mcp.json ~/.config/Code/User/mcp.json
# For VS Code (macOS)
cp mcp.json ~/Library/Application\ Support/Code/User/mcp.json选项B:使用角色特定配置
选择与您的角色相匹配的指南:
3.自定义配置
编辑您的 mcp.json 并替换占位符:
- `` → 您的GitHub个人访问令牌
- `` → 您的PostgreSQL连接字符串
- `` → 实际目录路径
- 其他凭证占位符
4.安装依赖项
# Core dependencies
node --version # Ensure Node.js v16+ is installed
npm install -g npm@latest
# Optional: Python tools (for uvx/DS Toolkit)
pip install uv
# Optional: Browser binaries
npx playwright install5.验证设置
./scripts/health-check.sh6.重新启动IDE
- VS代码/光标:
Ctrl+Shift+P→ “重新加载窗口” - 或者完全重新启动IDE
7.测试一下
在您的AI助手中尝试以下提示:
- “列出所有连接的MCP服务器”
- “显示\[您配置的路径\]中的文件”
- “\[你的GitHub仓库\]中的最新版本是什么?”
______________________________________________________________________
👥 角色特定指南
每份指南包括:
- ✅ 为您的角色推荐MCP服务器
- 📊 工具数量估计(均在性能限制范围内)
- 🎯 常见用例和工作流程
- 🔧 特定角色故障排除
- 💡 专业提示和最佳实践
🎨 前端开发人员
服务器:剧作家、Lighthouse、Chrome DevTools、Vitest、GitHub、文件系统\ 聚焦:UI测试、性能审计、浏览器自动化\ 工具:~50-60(远低于80限值)
______________________________________________________________________
⚙️ 后端开发人员
服务器:PostgreSQL、Redis、Supabase、Docker、GitHub、文件系统、顺序思维\ 聚焦:数据库操作、缓存、API开发、容器\ 工具:~60-70(远低于80限制)
______________________________________________________________________
🧪 QA/测试工程师
服务器:剧作家、木偶师、灯塔、Chrome DevTools、Vitest、GitHub\ 聚焦:跨浏览器测试、性能测试、自动化\ 工具:~55-65(远低于80限值)
______________________________________________________________________
📊 数据科学家
服务器:DS工具包、PostgreSQL、Redis、Kroki、GitHub、文件系统\ 聚焦:数据分析、统计计算、机器学习工作流程\ 工具:~50-60(远低于80限值)
______________________________________________________________________
🔧 包括MCP服务器
| 服务器 | 目的 | 命令 | 何时使用 |
|---|---|---|---|
| 文件系统 | 访问外部目录 | npx | 项目外的参考代码/文档 |
| GitHub | 存储库、PR、问题管理 | npx | 代码审查、发行说明 |
| PostgreSQL | 数据库查询与分析 | npx | 数据分析、调试查询 |
| 瑞迪斯 | 缓存检查和管理 | uvx | 缓存调试、性能 |
| Supabase | 后端即服务操作 | npx | Supabase项目管理 |
| 剧作家 | 跨浏览器自动化 | npx | 多浏览器测试 |
| 操纵者 | Chrome自动化 | npx | 仅限Chrome的快速测试 |
| 灯塔 | 性能和可访问性审计 | npx | 部署前验证 |
| Chrome工具 | 网络和性能调试 | npx | API调试,性能 |
| Vitest | JavaScript/TypeScript测试 | npx | 单元/组件测试分析 |
| 顺序思维 | 工作流和状态建模 | uvx | 复杂工艺设计 |
| 克罗基 | 图表生成 | npx | 架构图 |
| AWS图表 | AWS架构可视化 | uv | 云基础设施文档 |
| Docker MCP | 集装箱管理 | docker | 容器调试 |
| DS工具包 | 数据科学操作 | uvx | 统计分析,ML |
总计:16台MCP服务器,150多种工具可用
______________________________________________________________________
📁 项目结构
AmzMCPDevTools/
├── README.md # Project overview and quick start
├── TECHNICAL_GUIDE.md # Complete technical reference (1000+ lines)
├── CHANGELOG.md # Version history and updates
├── mcp.json # Production configuration (all 16 servers)
├── mcp.json.template # Template with placeholders
├── guides/
│ ├── README.md # Guides overview
│ ├── frontend-developer-setup.md
│ ├── backend-developer-setup.md
│ ├── qa-testing-setup.md
│ ├── data-scientist-setup.md
│ └── workflow-examples.md # 8 end-to-end scenarios
└── scripts/
└── health-check.sh # Configuration validator______________________________________________________________________
🛠️ 工具和脚本
健康检查脚本
验证您的MCP配置:
./scripts/health-check.sh检查:
- ✅ 配置文件的存在和语法
- ✅ Node.js、Python、Docker安装
- ✅ PostgreSQL、Redis服务状态
- ✅ 浏览器二进制文件(剧作家、木偶师)
- ✅ 工具数量与性能限制
- ⚠️ 配置警告和问题
输出示例:
╔══════════════════════════════════════════════════════╗
║ MCP Configuration Health Check ║
╚══════════════════════════════════════════════════════╝
[1/8] Checking MCP Configuration File...
✓ Found Cursor config: /home/user/.cursor/mcp.json
[2/8] Validating JSON Syntax...
✓ JSON syntax is valid
[3/8] Checking Core Dependencies...
✓ Node.js installed: v20.10.0
✓ npx available
✓ Python installed: Python 3.11.5
...
✓ All checks passed!
Your MCP configuration is healthy and ready to use.______________________________________________________________________
🚀 工作流示例
请参阅指南/工作流程示例.md 对于8个完整场景:
- 调试生产问题 -跟踪缓慢的API与DevTools,PostgreSQL,Redis
- 部署前验证 -测试套件、性能审计、数据库检查
- API开发 -设计、测试、记录新端点
- 数据管道分析 -调试数据质量问题
- 性能优化 -将页面加载时间从4秒提高到2秒以下
- 安全审计 -全面安全审查
- A/B测试分析 -统计分析和可视化
- 事件响应 -处理生产紧急情况
______________________________________________________________________
📊 性能指南
工具限制
- 光标:最好使用\<80个工具(6-8台服务器)
- VS Code:最好使用\<128个工具(10-12台服务器)
所有特定于角色的配置都经过优化,以保持在这些限制范围内!
提示
- ✅ 仅启用您正在使用的服务器
- ✅ 使用
disabled: true暂时关闭服务器 - ✅ 在IDE设置中监视工具计数
- ✅ 关闭未使用的浏览器实例
- ✅ 运行运行状况检查以验证安装程序
______________________________________________________________________
🤝 贡献
我们欢迎捐款!方法如下:
- 分叉 存储库
- 创建 特征分支:
git checkout -b feature/new-guide - 添加 您的贡献:
- 新的MCP服务器文档 - 特定角色指南 - 工作流示例 - Bug修复或改进
- 测试 您使用健康检查脚本所做的更改
- 提交:
git commit -m "Add: New DevOps guide" - 推:
git push origin feature/new-guide - 提交 拉取请求
贡献理念
- 🎯 新的特定角色指南(DevOps、移动等)
- 📝 其他工作流示例
- 🔧 新的MCP服务器配置
- 🐛 Bug修复和文档改进
- 🌍 翻译
______________________________________________________________________
📚 资源
官方文件
社区
- 出色的MCP服务器
- MCP Discord社区 (查看官方网站链接)
学习
______________________________________________________________________
📝 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
______________________________________________________________________
🙏 致谢
- 出色协议的模型上下文协议团队
- 用于AI集成的Cursor和VS Code团队
- 所有MCP服务器维护人员
- 社区贡献者
______________________________________________________________________
📧 支持
- 问题:
- 讨论:
- 电子邮件: support@amzuratg.com(如适用)
______________________________________________________________________
🌟 明星历史
如果这个项目对你有帮助,请⭐️ 把它放在GitHub上!
______________________________________________________________________
最后更新:2025年12月12日\ 版本: 2.0.0\ 由维护: 意大利
