MCP Server Analyzer

让每个人都能 3 分钟快速掌握任意 MCP Server，告别盲目踩坑。

English | 中文

效果预览

输入：[Level 2] 分析 @benborla29/mcp-server-mysql

输出：一份 500+ 行的完整使用手册
      ├── 复制即用的配置示例
      ├── 三层权限机制详解
      ├── 常见问题排查指南
      └── 多场景配置方案

查看完整范例：MySQL MCP Server 使用手册

痛点

MCP (Model Context Protocol) 生态正在爆发式增长。越来越多的 MCP Server 涌现，让 AI 助手能够连接数据库、操作文件系统、调用 API……

但问题来了：

| 痛点 | 表现 | |------|------| | 选型困难 | 同类 MCP Server 一堆，不知道哪个靠谱 | | 上手成本高 | 官方文档要么没有，要么看不懂，配置参数一头雾水 | | 踩坑重复 | 每个人都在重复踩一样的坑，团队知识无法沉淀 | | 版本混乱 | 不知道文档对应哪个版本，升级后配置失效 |

结果：明明 10 分钟能跑通的东西，往往要折腾半天。

解决方案

MCP Server Analyzer 是一套标准化的分析框架，让 AI 助手按照固定流程分析任意 MCP Server 开源项目，输出高质量、可复用的使用说明文档。

核心理念

输入：MCP Server 项目地址
      ↓
执行：标准化分析流程（SOP）
      ↓
输出：团队可直接使用的文档

三个分析级别

| 级别 | 时间 | 场景 | 输出 | |------|------|------|------| | Level 1 | 5-10 分钟 | 快速筛选，值不值得用 | 一句话总结 + 是否推荐 | | Level 2 | 30-60 分钟 | 正式接入项目（默认） | 完整使用手册 | | Level 3 | 2 小时+ | 深度定制、问题排查 | 源码解析报告 |

快速开始

30 秒上手

Step 1：复制下面的 Prompt

# Role: MCP Server Analyzer

你是一个专业的 MCP Server 分析专家，能够快速理解并分析任意 MCP Server 开源项目，输出高质量的使用说明文档。

## 分析级别

根据用户指定的级别执行不同深度的分析：

### Level 1: 快速评估（5-10分钟）
目标：判断这个 MCP Server 是否值得深入研究

执行步骤：
1. 定位项目源（GitHub/NPM）
2. 快速浏览 README
3. 识别核心 Tools

输出格式：
- 一句话总结
- 核心能力列表
- 是否值得深入 + 原因

### Level 2: 标准分析（30-60分钟）【默认】
目标：完成配置、跑通、理解核心能力，输出完整使用说明文档

执行步骤：
1. 项目基础信息收集（名称、版本、技术栈、依赖）
2. 环境配置分析（安装方式、环境变量、启动命令）
3. 核心能力梳理（Tools列表、运行模式、权限机制）
4. 配置参数整理（分类、默认值、必填项）
5. 常见问题预判
6. 输出标准文档

### Level 3: 深度研究（2小时+）
目标：源码级理解，适用于问题排查、能力扩展

执行步骤：
1. 源码结构分析
2. 核心流程追踪
3. 边界测试
4. 扩展可能性评估

## 默认行为

- 如果用户未指定级别，默认使用 **Level 2**
- 建议用户使用 `[Level X]` 前缀明确指定分析级别

## 输出规范

1. 使用 Markdown 格式
2. 配置示例使用真实可用的格式（如 mcp.json）
3. 更新日志必须包含：日期、文档版本、对应项目版本、分析级别、更新人、更新内容
4. 快速开始配置放在文档最前面，复制即用

Step 2：粘贴到你的 AI 助手

• Claude Desktop：Project Instructions
• ChatGPT：Custom Instructions 或 GPT Builder
• Cursor / Qoder：直接在对话中引用

Step 3：开始分析

[Level 2] 分析 @benborla29/mcp-server-mysql

[Level 1] 快速评估 mcp-server-redis

分析 https://github.com/anthropics/mcp-server-filesystem

功能特性

标准化输出

每份 Level 2 文档都包含：

| 模块 | 内容 | |------|------| | 快速开始 | 复制即用的配置，10 秒跑起来 | | 功能特性 | 支持哪些 Tools，能做什么 | | 环境要求 | Node.js、Python 版本要求 | | 核心概念 | 多模式、权限机制等复杂逻辑 | | 配置参数 | 所有参数的详细说明 | | 常见问题 | 预判的坑和解决方案 | | 场景示例 | 不同场景的完整配置 | | 更新日志 | 文档版本与项目版本对应 |

多平台支持

| 平台 | 使用方式 | |------|----------| | Claude Desktop | Project Instructions + Knowledge | | ChatGPT | Custom Instructions 或 GPT | | Cursor | 对话中引用文档 | | Qoder | 同 Cursor | | 其他 AI 助手 | 直接发送 Prompt |

使用示例

范例文档

• MySQL MCP Server 使用手册 - 完整的 Level 2 输出范例

Before vs After

Before（无 Skill）：

• 花 2 小时读源码
• 踩 N 个配置坑
• 写一堆零散笔记
• 下次还要重新摸索

After（有 Skill）：

• 3 分钟输出完整文档
• 配置直接复制能用
• 常见坑提前规避
• 团队直接复用

项目结构

mcp-server-analyzer/
├── README.md                       # 本文件（中文）
├── README_EN.md                    # 英文版
├── LICENSE                         # MIT 开源协议
├── skills.md                       # 核心 Prompt + 使用指南
├── resources/                      # 资源文件
│   ├── sop.md                      # 完整 SOP 流程文档
│   └── examples/                   # 输出范例
│       └── mysql.md                # MySQL MCP Server 范例
└── scripts/                        # 辅助脚本（后续扩展）

贡献指南

欢迎参与共建！

你可以

• 提 Issue：报告问题、提出建议
• 提 PR：
  • 添加新的 MCP Server 分析范例到 resources/examples/
  • 优化 SOP 流程或 Prompt
  • 补充 Level 1 / Level 3 模板
  • 添加辅助脚本到 scripts/

贡献范例格式

如果你用本 Skill 分析了新的 MCP Server，欢迎提交：

1. Fork 本仓库
2. 将你的分析文档放入 resources/examples/
3. 文件命名：{mcp-server-name}.md
4. 提交 PR，简要说明分析的 MCP Server

Roadmap

• [x] Level 2 核心流程
• [x] MySQL MCP Server 范例
• [ ] Level 1 / Level 3 完整模板
• [ ] 更多 MCP Server 范例（Redis、PostgreSQL、Filesystem...）
• [ ] 自动化分析脚本
• [ ] 中英文 Prompt 双版本

关于作者

李浩，一位有品位有追求的程序员，专注 AI 应用落地。

联系方式

• GitHub: https://github.com/lihao-agi

Star History

License

MIT

如果这个项目对你有帮助，请给个 Star ⭐️

先完成，再完美。社区共建，持续迭代。