Jira MCP Server

一个用于 Jira 的 Model Context Protocol 服务器。

通过 MCP 提供与 Jira 的集成，允许 LLM 与其交互。

Jira REST API 文档

安装

手动安装

注意：需要 Node 版本为 22.12.0 或以上

1. 创建或获取 Jira 个人访问令牌：指南

2. 将服务器配置添加到 Claude Desktop：

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: 查看此指南

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@parassolanki/jira-mcp-server@latest"],
      "env": {
        "JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
        "JIRA_BASE_URL": "jira_base_url"
      }
    }
  }
}

对于 Windows：

{
  "mcpServers": {
    "jira": {
      "command": "cmd /c npx",
      "args": ["-y", "@parassolanki/jira-mcp-server@latest"],
      "env": {
        "JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
        "JIRA_BASE_URL": "jira_base_url"
      }
    }
  }
}

组件

工具

1. list_projects: 列出 Jira 中的项目。

   • 必需输入：
     • query (可选字符串): 用于过滤返回项目的查询字符串。
     • maxResults (可选数字, 最大值: 100): 返回结果的最大数量。
     • expand (可选字符串): 在响应中扩展附加信息。(逗号分隔的 description, lead, issueTypes, url, projectKeys, permissions 和 insight )。

2. list_boards: 列出项目中的看板。

   • 必需输入：
     • projectKeyOrId (字符串): 项目的键或ID。
     • name (可选字符串): 项目的名称。
     • maxResults (可选数字, 最大值: 100): 返回结果的最大数量。
     • startAt (可选数字): 返回看板的起始索引。
     • type (可选字符串): 看板的类型。(可以是 scrum 或 kanban 中的一个)。

3. list_sprints_from_board: 列出看板中的冲刺。

   • 必需输入：
     • boardId (字符串): 看板的ID。
     • maxResults (可选数字, 最大值: 100): 返回结果的最大数量。
     • startAt (可选数字): 返回看板的起始索引。

4. list_issues_from_sprint: 列出冲刺中的问题。

   • 必需输入：
     • boardId (字符串): 看板的ID。
     • sprintId (字符串): 冲刺的ID。
     • maxResults (可选数字, 最大值: 100): 返回结果的最大数量。
     • startAt (可选数字): 返回看板的起始索引。
     • expand (可选字符串): 在响应中扩展附加信息。(逗号分隔的 schema 和 names)。

5. create_issue: 在 Jira 中创建一个问题 (仅支持任务类型)。

   • 必需输入：
     • projectKeyOrId (字符串): 项目的键或ID。
     • summary (字符串): 问题的摘要/标题。
     • description (字符串): 问题的描述。

使用示例

一些你可以用来与 Jira 互动的示例提示：

1. "显示所有 Jira 项目" → 执行 list_projects 工具以查看所有可用项目。
2. "DEV 项目中有哪些看板?" → 执行 list_boards 工具，并将 DEV 项目的键和类型参数设置为 "kanban"。
3. "显示与看板ID 123 相关的所有冲刺" → 执行 list_sprints_from_board 工具以查看与看板 123 相关的所有冲刺。
4. "在看板 123 上的冲刺 456 中有哪些问题?" → 执行 list_issues_from_sprint 工具以查看在看板 123 上的冲刺 456 中的所有问题。
5. "显示市场营销看板上当前冲刺的前 50 个问题" → 首先执行 list_boards 查找市场营销看板ID，然后执行 list_sprints_from_board 查找当前冲刺，最后执行 list_issues_from_sprint 并设置 maxResults=50。

开发

1. 安装依赖项：

pnpm install

2. 在 .env 中配置 Github 访问令牌：

JIRA_PERSONAL_ACCESS_TOKEN=email@example.com:your_personal_jira_access_token
JIRA_BASE_URL=jira_base_url

3. 使用 watch 模式本地运行：

pnpm dev

4. 构建服务器：

pnpm build

5. 使用 inspector 进行本地调试：

pnpm inspector

待办事项

• list_projects
• list_boards
• list_sprints_from_board
• list_issues_from_sprint
• get_issue_by_id_or_key
• create_issue (仅支持任务类型)
• create_issue (故事、史诗、子任务类型)
• update_issue
• 删除一个问题
• 归档一个问题
• 列出问题中的评论
• 根据ID获取问题中的评论
• 在问题中创建评论
• 更新问题中的评论
• 删除问题中的评论
• 列出问题中的子任务
• 根据用户名或键获取用户