用途
qasphere-mcp 是面向 QA Sphere 测试管理系统（TMS）的 Model Context Protocol（MCP）服务器，用于把 QA Sphere 的测试用例接入支持 MCP 的 AI 客户端与 AI 增强型 IDE。通过这一集成，大语言模型可以直接与 QA Sphere 的测试用例交互，实现发现、汇总和围绕测试用例的对话，并可在开发工作流中引用具体的 QA Sphere 测试用例。
主要能力
根据仓库说明，该集成使大语言模型能够直接访问 QA Sphere 测试用例，支持以下操作：发现测试用例、汇总测试用例、围绕测试用例进行对话。在支持 MCP 的 AI 增强型 IDE 中，可以在开发工作流内引用特定的 QA Sphere 测试用例。
维护状态与迁移说明
该仓库已归档，不再维护。QA Sphere 现在直接提供 MCP 服务器，无需再运行这个独立包。托管的服务器始终与 QA Sphere API 保持同步，会按你的角色开放全部允许使用的工具，并且不需要在本地安装任何内容。
推荐设置方式：在 QA Sphere 中进入 Settings ⚙️ → MCP Server，选择你的助手和访问级别，添加 API key，然后按页面中显示的安装说明操作。详细说明可参见 QA Sphere 文档。
仓库中保留的说明仅作参考。运行独立服务器时，它会在每个会话中提示一次迁移事项；设置环境变量 QASPHERE_MCP_HIDE_MIGRATION_NOTICE=1 可以关闭该提示。
使用方式（独立服务器，仅作参考）
前置条件：
- 具备 API 访问权限的 QA Sphere 账户
- QA Sphere 的 API key（Settings ⚙️ → API Keys → Add API Key）
- 你所在公司的 QA Sphere URL（例如 example.eu2.qasphere.com）
该服务器兼容任何 MCP 客户端。仓库提供了常见客户端的配置说明：
Claude：
- 进入 Claude → Settings → Developer → Edit Config
- 打开 claude_desktop_config.json
- 在 mcpServers 字典中添加 QA Sphere 配置
Cursor：
- 进入 Settings... → Cursor settings → Add new global MCP server
- 添加 QA Sphere 配置
仓库还提供了一个自动安装并配置 QA Sphere MCP 服务器的按钮。
其他 MCP 客户端（含 Tool 表单方式）的配置步骤：
- 打开 'Tools' 并点击 'New'
- 在表单中填写：Tool key: qasphere；Command: npx -y qasphere-mcp；以及环境变量（见下文）
通用配置模板：任何 MCP 客户端都可以使用仓库给出的配置格式，需要把占位符替换为实际的 QA Sphere URL 和 API key。
适用场景
- 在支持 MCP 的 AI 客户端或 AI 增强型 IDE 中访问 QA Sphere 测试用例
- 让大语言模型发现、汇总并讨论测试用例
- 在开发工作流中引用具体的 QA Sphere 测试用例
限制
- 本仓库已归档且不再维护
- QA Sphere 现已直接提供托管的 MCP 服务器，不建议再运行该独立包
- 使用独立服务器需要 QA Sphere 账户（含 API 访问权限）、API key 以及公司的 QA Sphere URL
- 项目采用 MIT 许可证，详见仓库中的 LICENSE 文件
- 如遇问题或需要帮助，请在 GitHub 仓库中提交 issue
其他细节（如具体客户端版本要求、角色与工具权限的具体划分等）暂未提供。
