Jira MCP 服务器

Jira 的模型上下文协议服务器。

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

Jira REST Api 文档

安装

手动安装

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

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

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

   • MacOS：〜/资源库/应用程序支持/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"
      }
    }
  }
}

Related MCP server: Jira MCP Server

成分

工具

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 号板上的 sprint 456 中有哪些问题？” → 执行 list_issues_from_sprint 工具查看 123 号板上的 sprint 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. 使用检查器进行本地调试：

pnpm inspector

待办事项

• [x] 列出项目

• [x] 列表板

• [x] 列出来自板的冲刺

• [x] 列出来自冲刺的问题

• [ ] 通过 ID 或密钥获取问题

• [x] create_issue（仅限任务问题类型）

• [ ] create_issue（故事、史诗、子任务问题类型）

• [ ] update_issue

• [ ] 删除问题

• [ ] 归档问题

• [ ] 列出来自问题的评论

• [ ] 根据问题 ID 获取评论

• [ ] 在问题中创建评论

• [ ] 更新问题评论

• [ ] 删除问题评论

• [ ] 列出来自问题的子任务

• [ ] 通过用户名或密钥获取用户