Jira Cloud

Name: Jira Cloud
Author: aaronsb

本地服务

github.com生产力45 周前更新

代码仓库访问官网

关于 Jira Cloud

Jira Cloud MCP Server 将 MCP 客户端连接到 Jira Cloud，用于处理问题、项目、看板、冲刺和筛选器。它还通过资源提供实例与项目数据、自定义字段目录及工具文档。

主要功能

01创建和管理问题
02使用 JQL 搜索并管理筛选器
03管理项目、看板和冲刺
04通过结果引用批量执行操作
05分析问题指标与数量
06提供实例和自定义字段资源

适用场景

01更新问题和冲刺分配
02执行基于 JQL 的问题分析
03查看项目和看板概况
04查找问题类型对应的自定义字段

MCP 相关

这是用于 Jira Cloud 的 MCP 服务，向客户端提供 Jira 操作工具，以及实例、项目、看板、自定义字段和文档资源。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "aaronsb-jira-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@aaronsb/jira-cloud-mcp"
      ],
      "env": {
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
        "JIRA_EMAIL": "<JIRA_EMAIL>",
        "JIRA_HOST": "<JIRA_HOST>"
      }
    }
  }
}

启动命令npx -y @aaronsb/jira-cloud-mcp

需要配置的环境变量

JIRA_API_TOKEN密钥Jira API token (generate at https://id.atlassian.com/manage/api-tokens)

JIRA_EMAILAtlassian account email address

JIRA_HOSTJira instance URL (e.g., https://your-team.atlassian.net)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@aaronsb/jira-cloud-mcp0.11.3stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
jql	string	否	JQL 查询字符串。create 和 execute_jql 必填。语法示例请参阅 jira://tools/manage_jira_filter/documentation。
name	string	否	筛选器名称。create 时必填。
expand	array	否	要在响应中包含的其他字段。
startAt	integer	否	分页偏移量（从 0 开始）。
filterId	string	否	筛选器 ID。get、update、delete、execute_filter 时必填。
favourite	boolean	否	标记为收藏。
operation	enum	是	要执行的操作get \| create \| update \| delete \| list \| execute_filter \| execute_jql
maxResults	integer	否	要返回的最大项目数。
description	string	否	筛选器描述。
sharePermissions	array	否	筛选器的共享权限。

详细介绍

Jira Cloud MCP 服务

用于与 Jira Cloud 实例交互的模型上下文协议服务。

安装

Claude Desktop（一键安装）

下载 jira-cloud-mcp.mcpb 并打开，Claude Desktop 将提示你输入 Jira 凭据。

Claude Code

claude mcp add jira-cloud -e JIRA_API_TOKEN=your-token -e JIRA_EMAIL=your-email -e JIRA_HOST=https://your-team.atlassian.net -- npx -y @aaronsb/jira-cloud-mcp

手动安装（适用于任何 MCP 客户端）

{
  "mcpServers": {
    "jira-cloud": {
      "command": "npx",
      "args": ["-y", "@aaronsb/jira-cloud-mcp"],
      "env": {
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_EMAIL": "your-email",
        "JIRA_HOST": "https://your-team.atlassian.net"
      }
    }
  }
}

凭据

在 Atlassian Account Settings 中生成 API 令牌。

工具

工具	描述
`manage_jira_issue`	获取、创建、更新、删除、移动、转换、评论、关联问题，或遍历问题层级
`manage_jira_filter`	使用 JQL 查询搜索问题，或管理已保存的筛选器
`manage_jira_project`	列出项目，或获取项目配置和元数据
`manage_jira_board`	列出看板，或获取看板详情和配置
`manage_jira_sprint`	管理冲刺：创建、启动、关闭冲刺，并将问题分配到冲刺
`queue_jira_operations`	批量执行多个操作，支持结果引用（`$0.key`）和错误处理策略
`analyze_jira_issues`	对通过 JQL 选出的问题计算指标、精确计数并进行数据立方体分析

每个工具都接受一个 operation 参数（queue_jira_operations 除外，它接受 operations 数组；analyze_jira_issues 接受 jql 和 metrics）。每个工具的文档均可通过 MCP 资源 jira://tools/{tool_name}/documentation 获取。

有关详细的工具说明、工作区模式和设计原则，请参阅 docs/tools.md。

MCP 资源

资源	描述
`jira://instance/summary`	实例级统计信息
`jira://projects/distribution`	项目分布概览
`jira://projects/{key}/overview`	包含状态计数的项目概览
`jira://boards/{id}/overview`	包含冲刺信息的看板概览
`jira://issue-link-types`	可用的问题链接类型
`jira://custom-fields`	自定义字段目录（启动时自动发现）
`jira://custom-fields/{project}/{issueType}`	特定上下文中的自定义字段
`jira://analysis/recipes`	分析查询模式和计算 DSL 参考
`jira://tools/{name}/documentation`	每个工具的文档