jira-mcp-server

Jira MCP Server

一个适用于 Jira 的 MCP 服务 — 将任何兼容 MCP 的客户端连接到你的 Jira 项目、问题、迭代和看板。

这是什么？

一个 MCP（Model Context Protocol） 服务，可让 AI 助手和 Agent 完全访问你的 Jira 实例 — 使用 JQL 搜索问题、创建和更新工单、管理迭代和看板、通过工作流流转问题，以及关联相关工作 — 全部通过自然语言完成。

将它与 Claude Desktop、Cursor、Windsurf、Cline、Continue 或任何兼容 MCP 的客户端搭配使用，无需离开聊天界面即可管理项目。

为什么使用它？

• 14 个内置工具 — 涵盖搜索、CRUD、状态流转、评论、项目、看板、迭代和待办事项
• 完整支持 JQL — 使用任意 Jira 查询语言表达式搜索问题
• 工作流流转 — 按名称将问题流转到自定义工作流中的不同状态
• 迭代管理 — 查询迭代状态、目标和看板待办事项
• 适用于 Jira Cloud — 可连接到任何 *.atlassian.net 实例

快速开始

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp-server"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Cursor / VS Code

将以下内容添加到你的 MCP 配置中：

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp-server"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

手动配置

npm install -g jira-mcp-server
export JIRA_HOST=your-domain.atlassian.net
export [email protected]
export JIRA_API_TOKEN=your-api-token
jira-mcp-server

环境变量

变量	必填	说明
JIRA_HOST	是	你的 Jira 主机名（例如 your-domain.atlassian.net）
JIRA_API_TOKEN	是	Jira API 令牌或个人访问令牌
JIRA_EMAIL	条件必填	你的 Jira 邮箱（Basic 身份验证必需）
JIRA_AUTH_TYPE	否	basic（默认）或 bearer（用于 PAT）
JIRA_API_VERSION	否	REST API 版本（默认：3）

获取 API 令牌

1. 前往 Atlassian API Tokens
2. 点击 Create API token
3. 为令牌命名（例如“MCP Server”）并复制令牌
4. 将你的 Atlassian 邮箱用作 JIRA_EMAIL

工具

工具	说明
jira_search	使用 JQL 搜索问题
jira_get_issue	获取问题的完整详情
jira_create_issue	创建新问题
jira_update_issue	更新问题字段
jira_transition_issue	将问题流转到新状态
jira_add_comment	为问题添加评论
jira_delete_issue	删除问题（永久删除）
jira_list_projects	列出可访问的项目
jira_get_project	获取项目详情
jira_get_issue_types	列出项目的问题类型
jira_link_issues	在两个问题之间创建关联
jira_get_boards	列出 Jira Software 看板
jira_get_sprints	列出看板的迭代
jira_get_backlog	获取看板待办事项

使用示例

使用 JQL 搜索问题

{ "tool": "jira_search", "arguments": { "jql": "project = PROJ AND status = Open ORDER BY created DESC" } }

创建 Bug

{
  "tool": "jira_create_issue",
  "arguments": {
    "projectKey": "PROJ",
    "summary": "Login page broken on mobile",
    "issueType": "Bug",
    "priority": "High",
    "labels": "mobile,urgent"
  }
}

流转问题

{ "tool": "jira_transition_issue", "arguments": { "issueKey": "PROJ-123", "transitionName": "In Progress" } }

获取迭代待办事项

{ "tool": "jira_get_backlog", "arguments": { "boardId": "42" } }

使用场景

• 项目管理 — “显示移动项目中所有未解决的 Bug” → 使用 JQL 调用 jira_search
• 迭代规划 — “当前迭代里有什么？” → jira_get_sprints + jira_get_backlog
• 问题分诊 — “为登录超时创建一个 Bug” → jira_create_issue
• 工作流自动化 — “将 PROJ-456 移至 In Review” → jira_transition_issue
• 跨项目概览 — “列出我有权访问的所有项目” → jira_list_projects

API Coverage

Resource	Tools
Issues	jira_search, jira_get_issue, jira_create_issue, jira_update_issue, jira_transition_issue, jira_delete_issue
Comments	jira_add_comment
Projects	jira_list_projects, jira_get_project
Issue Types	jira_get_issue_types
Links	jira_link_issues
Boards	jira_get_boards
Sprints	jira_get_sprints
Backlog	jira_get_backlog

Development

git clone https://github.com/friendlygeorge/jira-mcp-server.git
cd jira-mcp-server
npm install
npm run build
npm start

License

MIT