使用说明

项目简介

'hh-jira-mcp-server' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 LLM 应用提供与 Jira 系统交互的能力。通过此 MCP 服务器，LLM 可以执行诸如在 Jira 中搜索团队 Portfolio、创建新的 Jira 任务以及更新 Jira 任务状态等操作，从而实现更智能化的工作流程自动化和信息获取。

主要功能点

搜索团队 Portfolio: 允许 LLM 根据团队名称在 Jira 中搜索并获取相关的 Portfolio 信息。
创建 Jira 任务: 允许 LLM 在 Jira 中创建新的任务，并自动分配给指定用户和团队。
设置防御检查: 允许 LLM 更新 Jira Portfolio 任务，标记为已完成安全防御检查。

安装步骤

安装 Claude Desktop (可选): 如果您计划将此 MCP 服务器与 Claude 客户端一起使用，请先安装 Claude Desktop 客户端。
安装 uv: 这是一个 Python 包管理工具，用于项目依赖管理和构建。您可以使用 Homebrew 安装 uv：
```
brew install uv
```
安装 keyring: 'keyring' 用于安全地存储和访问 Jira 密码。您可以使用 'uv pip' 安装 keyring：
```
uv pip install keyring
```
存储 Jira 密码: 为了安全地访问 Jira，您需要使用 'keyring' 存储 Jira 用户名对应的密码。请将 '<jira_username>' 替换为您的 Jira 用户名。
```
keyring set hh-jira-mcp-server <jira_username>
```

服务器配置 (MCP 客户端配置)

以下 JSON 配置信息用于配置 MCP 客户端 (例如 Claude) 连接到 'hh-jira-mcp-server' MCP 服务器。您需要将此配置添加到您的 MCP 客户端配置中。

{
  "mcpServers": {
    "hh-jira-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "hh-jira-mcp-server"
      ],
      "env": {
        "HH_JIRA_MCP_USER": "<your_jira_username>",  // 您的 Jira 用户名
        "HH_JIRA_MCP_TEAM": "<your_jira_team>",     // 您的 Jira 团队名称
        "HH_JIRA_MCP_SEARCH_FILTER": "status in (\"Development: In progress\")" // Jira 搜索过滤器，用于限制搜索结果范围
      }
    }
  }
}

请务必替换以下占位符：

'<your_jira_username>': 您的 Jira 用户名。
'<your_jira_team>': 您的 Jira 团队名称。

'HH_JIRA_MCP_SEARCH_FILTER' 环境变量允许您自定义 Jira 搜索过滤器，以更精确地控制搜索结果。

基本使用方法

完成服务器配置后，您的 MCP 客户端 (如 Claude) 应该能够连接到 'hh-jira-mcp-server'。您可以通过自然语言指令指示 LLM 客户端调用服务器提供的工具。例如，您可以向 LLM 提出类似以下请求：

"搜索 '<your_jira_team>' 团队的活跃 Portfolio" (触发 'search_team_active_portfolios' 工具)
"创建一个标题为 '实现新功能' 的 Jira 任务" (触发 'create_task' 工具)
"将 Portfolio 编号 123 标记为已完成防御检查" (触发 'set_defence_checked' 工具，针对 PORTFOLIO-123)

LLM 客户端会将这些自然语言指令转换为对 MCP 服务器特定工具的调用，从而实现与 Jira 系统的交互。

关键词