Jira MCP 服务器

一个用于 Jira 的 模型上下文协议 服务器。

通过 MCP 提供与 Jira 的集成，允许大型语言模型与其交互。

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项目中有哪些看板？" → 使用DEV项目的key并设置type参数为"kanban"来执行list_boards工具。
3. "显示ID为123的看板的所有sprint" → 执行list_sprints_from_board工具以查看与看板123相关联的所有sprint。
4. "在看板123上的sprint 456中有什么问题？" → 执行list_issues_from_sprint工具以查看看板123上sprint 456中的所有问题。
5. "显示营销看板当前sprint中的前50个问题" → 首先执行list_boards找到营销看板ID，然后使用list_sprints_from_board找到当前sprint，接着使用maxResults=50参数执行list_issues_from_sprint。

开发

1. 安装依赖项：

pnpm install

1. 在.env文件中配置Github访问令牌：

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

1. 带有监视运行本地服务：

pnpm dev

1. 构建服务器：

pnpm build

1. 使用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
• 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