Jira MCP Server

Jira MCP 服务

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

通过 MCP 与 Jira 集成，让大模型能够与其交互。

Jira REST Api Docs

安装

手动安装

注意：需要 Node 版本为 22.12.0 或更高版本

1. 创建或获取 Jira Personal Access Token：指南

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 protected]: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 protected]: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（字符串）：项目的 Key 或 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 中创建问题（仅支持 Task 问题类型）。

   • 必需输入：
     • projectKeyOrId（字符串）：项目的 Key 或 Id。
     • summary（字符串）：问题的摘要／标题。
     • description（字符串）：问题描述。

使用示例

以下是一些可用于与 Jira 交互的提示词示例：

1. “显示所有 Jira 项目” → 执行 list_projects 工具，查看所有可用项目。
2. “DEV 项目中有哪些 Kanban 看板？” → 使用 DEV 项目 Key 执行 list_boards 工具，并将 type 参数设为 "kanban"。
3. “显示看板 ID 123 的所有冲刺” → 执行 list_sprints_from_board 工具，查看与看板 123 关联的所有冲刺。
4. “看板 123 上的冲刺 456 中有哪些问题？” → 执行 list_issues_from_sprint 工具，查看看板 123 上冲刺 456 中的所有问题。
5. “显示 Marketing 看板当前冲刺中的前 50 个问题” → 先执行 list_boards 查找 Marketing 看板 ID，然后执行 list_sprints_from_board 查找当前冲刺，最后执行 list_issues_from_sprint 并设置 maxResults=50。

开发

1. 安装依赖：

pnpm install

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

[email protected]:your_personal_jira_access_token
JIRA_BASE_URL=jira_base_url

3. 在本地运行并监听变更：

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（仅限 task issue 类型）
• create_issue（story、epic、sub-task issue 类型）
• update_issue
• delete_an_issue
• archieve_an_issue
• list_comments_from_issue
• get_comment_from_issue_by_id
• create_comment_in_issue
• update_comment_of_issue
• delete_comment_of_issue
• list_subtasks_from_issue
• get_user_by_username_or_key