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 分