AI导哈

MCP配置工具包

一个为AI编程助手（如Cursor、VS Code Copilot）提供MCP服务器配置、角色指南和工作流示例的全面工具包，旨在增强开发效率与外部工具集成能力。

  • by AmzurATG
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 AmzurATG/AmzMCPDevTools

使用说明

🚀 AmzMCPDevTools

用于AI驱动开发的综合MCP（模型上下文协议）配置工具包

精心策划的MCP服务器配置、角色特定指南和工作流示例集合，通过强大的外部工具集成为您的AI编码助手（Cursor、VS Code Copilot）提供动力。

📋 目录

🎯 什么是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 AmzMCPDevTools

2.选择你的道路

选项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 并替换占位符：

  • <YOUR_GITHUB_TOKEN> → 您的GitHub个人访问令牌
  • <YOUR_POSTGRES_URL> → 您的PostgreSQL连接字符串
  • <ABSOLUTE_PATH> → 实际目录路径
  • 其他凭证占位符

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 install

5.验证设置

./scripts/health-check.sh

6.重新启动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个完整场景：

  1. 调试生产问题 -跟踪缓慢的API与DevTools，PostgreSQL，Redis
  2. 部署前验证 -测试套件、性能审计、数据库检查
  3. API开发 -设计、测试、记录新端点
  4. 数据管道分析 -调试数据质量问题
  5. 性能优化 -将页面加载时间从4秒提高到2秒以下
  6. 安全审计 -全面安全审查
  7. A/B测试分析 -统计分析和可视化
  8. 事件响应 -处理生产紧急情况

📊 性能指南

工具限制

  • 光标：最好使用<80个工具（6-8台服务器）
  • VS Code：最好使用<128个工具（10-12台服务器）

所有特定于角色的配置都经过优化，以保持在这些限制范围内！

提示

  • ✅ 仅启用您正在使用的服务器
  • ✅ 使用 disabled: true 暂时关闭服务器
  • ✅ 在IDE设置中监视工具计数
  • ✅ 关闭未使用的浏览器实例
  • ✅ 运行运行状况检查以验证安装程序

🤝 贡献

我们欢迎捐款！方法如下：

  1. 分叉 存储库
  2. 创建 特征分支： git checkout -b feature/new-guide
  3. 添加 您的贡献：
    • 新的MCP服务器文档
    • 特定角色指南
    • 工作流示例
    • Bug修复或改进
  4. 测试 您使用健康检查脚本所做的更改
  5. 提交: git commit -m "Add: New DevOps guide"
  6. 推: git push origin feature/new-guide
  7. 提交 拉取请求

贡献理念

  • 🎯 新的特定角色指南（DevOps、移动等）
  • 📝 其他工作流示例
  • 🔧 新的MCP服务器配置
  • 🐛 Bug修复和文档改进
  • 🌍 翻译

📚 资源

官方文件

社区

学习

📝 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

  • 出色协议的模型上下文协议团队
  • 用于AI集成的Cursor和VS Code团队
  • 所有MCP服务器维护人员
  • 社区贡献者

📧 支持

🌟 明星历史

如果这个项目对你有帮助，请⭐️ 把它放在GitHub上！

最后更新：2025年12月12日
版本: 2.0.0
由维护: 意大利

相关 MCP