github-mpc

验证并配置所需的MCP服务器(Atlassian和GitHub)以启用Product Guide Writer集成,缺失时引导设置。

安装

概览

GitHub-MPC 是一个用于验证和配置 Product Guide Writer 工作流程所需 MCP(Model Context Protocol)服务器的技能工具。该工具专门帮助用户在首次使用 Product Guide Writer 时,或遇到与 MCP 相关的错误时,确保所需的外部集成服务已正确设置。Product Guide Writer 依赖多个 MCP 服务器来提供 Atlassian(Confluence 和 Jira)以及 GitHub 的集成功能,因此本工具的核心作用是保障这些前置条件得到满足。 该技能通过检查本地 MCP 配置文件目录,确认必需的 MCP 服务器是否已启用并连接正常。它支持检测 user-atlassian、user-github、user-Figma 和 user-elasticsearch-mcp 等服务器状态,并针对缺失或配置错误的 MCP 提供详细的引导式设置流程。例如,若 Atlassian MCP 未安装,工具会指导用户通过 Cursor 设置界面添加官方 Atlassian MCP 服务器,并完成身份认证;对于 GitHub MCP,则会提示配置 Personal Access Token 并验证仓库访问权限。整个过程旨在降低集成门槛,提升开发者在文档编写环境搭建阶段的效率。

核心功能特点

  1. 自动检测必需的 MCP 服务器是否已配置并运行
  2. 提供分步引导以安装和配置缺失的 Atlassian 和 GitHub MCP
  3. 支持验证 Confluence GT 空间访问权限及页面操作能力
  4. 可测试 MCP 连接性并返回详细的资源访问列表
  5. 包含可选 MCP(如 Figma 和 Elasticsearch)的安装与使用建议

适用场景

GitHub-MPC 最适用于在开始使用 Product Guide Writer 前进行环境初始化,尤其是在新设备上部署开发环境或团队协作中首次接入项目时。当用户首次启动 Product Guide Writer 工作流时,该工具会自动触发 MCP 检查,避免因缺少集成服务而导致后续步骤失败。此外,在遇到 Atlassian 或 GitHub 相关错误信息时,此技能可作为快速诊断手段,帮助用户定位问题根源——比如认证失效、权限不足或服务器未安装。 另一个典型应用场景是解决跨系统集成问题,例如在尝试搜索现有 Confluence 文档或发布新页面时出现“MCP server not found”或“Permission denied”等提示。此时,GitHub-MPC 不仅能识别出具体哪个 MCP 缺失,还能提供针对性的修复指南,包括如何获取正确的 Cloud ID、设置环境变量以及重新授权账户。对于需要结合代码库进行文档撰写的场景,该工具同样关键:它能确保 GitHub MCP 能够访问 Trading212 组织下的仓库,从而支持代码搜索与文件内容检索功能,为生成准确的技术文档奠定基础。