Jira Zephyr MCP Python V2

Jira Zephyr MCP服务器

一种模型上下文协议（MCP）服务器，为AI助手提供对JIRA和Zephyr Scale测试管理系统的编程访问。

特性

• 14 MCP工具 用于全面的测试管理
• 异步HTTP客户端 具有重试逻辑和错误处理
• 安全的凭证管理 有环境变量
• 结构化日志记录 带有凭证编辑功能
• 输入验证 使用Pydantic模式
• 自然语言命令界面 用于直观的交互

需求

• Python>=3.12
• 具有API访问权限的JIRA云帐户
• Zephyr Scale API访问

安装

# Clone the repository
git clone 
cd jira-zephyr-mcp-python-v2

# Install dependencies using uv (recommended)
uv sync

# Or using pip
pip install -e .

配置

创建一个 .env 项目根目录中的文件：

cp .env.example .env

编辑 .env 使用您的凭据：

JIRA__BASE_URL=https://your-domain.atlassian.net
JIRA__EMAIL=your-email@company.com
JIRA__API_TOKEN=your-jira-api-token

ZEPHYR__BASE_URL=https://api.zephyrscale.smartbear.com/v2
ZEPHYR__API_TOKEN=your-zephyr-api-token

DEBUG=false

用法

启动MCP服务器

# Using uv
uv run jira_zephyr_mcp serve

# Or if installed
jira_zephyr_mcp serve

检查版本

jira_zephyr_mcp version

获得帮助

jira_zephyr_mcp --help

MCP客户端配置

VS代码与GitHub Copilot

添加到您的 .vscode/settings.json 或用户设置：

{
  "github.copilot.chat.mcp.servers": {
    "jira-zephyr": {
      "command": "uv",
      "args": ["run", "jira_zephyr_mcp", "serve"],
      "env": {
        "JIRA__BASE_URL": "https://your-domain.atlassian.net",
        "JIRA__EMAIL": "your-email@company.com",
        "JIRA__API_TOKEN": "your-jira-token",
        "ZEPHYR__BASE_URL": "https://api.zephyrscale.smartbear.com/v2",
        "ZEPHYR__API_TOKEN": "your-zephyr-token"
      }
    }
  }
}

克劳德桌面

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "jira-zephyr": {
      "command": "uv",
      "args": ["run", "jira_zephyr_mcp", "serve"],
      "env": {
        "JIRA__BASE_URL": "https://your-domain.atlassian.net",
        "JIRA__EMAIL": "your-email@company.com",
        "JIRA__API_TOKEN": "your-jira-token",
        "ZEPHYR__BASE_URL": "https://api.zephyrscale.smartbear.com/v2",
        "ZEPHYR__API_TOKEN": "your-zephyr-token"
      }
    }
  }
}

可用工具

1. read_jira_issue -阅读JIRA问题详细信息
2. 创建测试计划 -创建新的测试计划
3. list_test_plans -列出现有测试计划
4. create_test_cycle -创建新的测试执行周期
5. list_test_cycles -列出现有测试周期
6. execute_test -更新测试执行结果
7. get_testexecution_status -获取执行统计数据
8. link_test_to_oissues -将测试用例链接到JIRA问题
9. generate_test_report -生成测试执行报告
10. create_test_case -创建新的测试用例
11. 搜索测试案例 -搜索测试用例
12. get_test_case -获取详细的测试用例信息
13. 创建多个测试用例 -批量创建测试用例
14. nl_命令 -自然语言命令界面
15. 健康检查 -检查服务器和API运行状况

发展

运行测试

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov=jira_zephyr_mcp

# Run specific test file
uv run pytest tests/unit/test_config.py

类型检查

# Using mypy
uv run mypy src/jira_zephyr_mcp

# Using pyright
uv run pyright

装订和格式化

# Check code style
uv run ruff check .

# Format code
uv run ruff format .

许可证

麻省理工学院

贡献

欢迎投稿！请打开问题或提交拉取请求。