Jira Mcp Server

io.github.friendlygeorge由 GitHub 账号 friendlygeorge 发布v1.0.0更新于 Oct 24, 2026

MCP server for Jira — search, create, update, transition issues, manage projects, boards, and spr...

已验证STDIO仅桌面效率与工作流开发者工具

概览

AI 生成的概览

一个本地 MCP 服务器，将 AI 助手连接到 Jira Cloud，可搜索、创建、更新和流转工单，并查看项目、看板和冲刺。

可以做什么
使用 JQL 搜索和读取工单，包括工单完整详情和项目下的工单类型，并列出可访问的项目及其详情。创建、更新、流转和永久删除工单，以及添加评论。将相关工单互相链接。列出 Jira Software 看板、其冲刺以及看板待办事项。
适用场景
适合在 Jira Cloud 中管理工作的人，希望在聊天客户端里而非 Jira 界面中分诊、创建或移动工单、规划冲刺或获取跨项目概览时使用。
运行要求
通过 npx 或全局 npm 安装本地运行（需要 Node.js）。需要在 JIRA_HOST 中设置 Jira Cloud 主机，在 JIRA_API_TOKEN 中提供 API 令牌或个人访问令牌，基本认证还需 JIRA_EMAIL；JIRA_AUTH_TYPE 和 JIRA_API_VERSION 可选。需要能访问 Atlassian 实例的网络。
安装前请注意
JIRA_API_TOKEN 中的令牌可访问你的 Jira 数据，应限制权限并妥善保密。该服务器可写入 Jira：创建、更新、流转、评论、链接以及永久删除工单，因此助手的操作可能更改或删除真实工单。工单内容会发送到所配置的 Jira 主机。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Jira Mcp Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Jira MCP Server

An MCP server for Jira — connect any MCP-compatible client to your Jira projects, issues, sprints, and boards.

[MCP Compatible] [TypeScript] [License: MIT]

What is this?

An MCP (Model Context Protocol) server that gives AI assistants and agents full access to your Jira instance — search issues with JQL, create and update tickets, manage sprints and boards, transition issues through workflows, and link related work — all through natural language.

Use it with Claude Desktop, Cursor, Windsurf, Cline, Continue, or any MCP-compatible client to manage your projects without leaving the chat.

Why use this?

  • 14 built-in tools — covers search, CRUD, transitions, comments, projects, boards, sprints, and backlog
  • Full JQL support — search issues with any Jira Query Language expression
  • Workflow transitions — move issues through your custom workflows by name
  • Sprint management — query sprint states, goals, and board backlogs
  • Works with Jira Cloud — connects to any *.atlassian.net instance

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

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

Add to your MCP configuration:

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"      }    }  }}

Manual

bash
npm install -g jira-mcp-serverexport JIRA_HOST=your-domain.atlassian.netexport [email protected]export JIRA_API_TOKEN=your-api-tokenjira-mcp-server

Environment Variables

VariableRequiredDescription
JIRA_HOSTYesYour Jira hostname (e.g. your-domain.atlassian.net)
JIRA_API_TOKENYesJira API token or Personal Access Token
JIRA_EMAILCond.Your Jira email (required for Basic auth)
JIRA_AUTH_TYPENobasic (default) or bearer (for PAT)
JIRA_API_VERSIONNoREST API version (default: 3)

Getting your API token

  1. Go to Atlassian API Tokens
  2. Click Create API token
  3. Give it a name (e.g. "MCP Server") and copy the token
  4. Use your Atlassian email as JIRA_EMAIL

Tools

ToolDescription
jira_searchSearch issues with JQL
jira_get_issueGet full issue details
jira_create_issueCreate a new issue
jira_update_issueUpdate issue fields
jira_transition_issueTransition issue to new status
jira_add_commentAdd a comment to an issue
jira_delete_issueDelete an issue (permanent)
jira_list_projectsList accessible projects
jira_get_projectGet project details
jira_get_issue_typesList issue types for a project
jira_link_issuesCreate a link between two issues
jira_get_boardsList Jira Software boards
jira_get_sprintsList sprints for a board
jira_get_backlogGet board backlog items

Usage Examples

Search issues with JQL

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

Create a bug

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

Transition an issue

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

Get sprint backlog

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

Use Cases

  • Project management — "Show me all open bugs in the mobile project" → jira_search with JQL
  • Sprint planning — "What's in the current sprint?" → jira_get_sprints + jira_get_backlog
  • Issue triage — "Create a bug for the login timeout" → jira_create_issue
  • Workflow automation — "Move PROJ-456 to In Review" → jira_transition_issue
  • Cross-project overview — "List all projects I have access to" → jira_list_projects

API Coverage

ResourceTools
Issuesjira_search, jira_get_issue, jira_create_issue, jira_update_issue, jira_transition_issue, jira_delete_issue
Commentsjira_add_comment
Projectsjira_list_projects, jira_get_project
Issue Typesjira_get_issue_types
Linksjira_link_issues
Boardsjira_get_boards
Sprintsjira_get_sprints
Backlogjira_get_backlog

Development

bash
git clone https://github.com/friendlygeorge/jira-mcp-server.gitcd jira-mcp-servernpm installnpm run buildnpm start

License

MIT

来源：README.md，提交 4178fd7

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分