Skip to main content
Glama
Sign In
deenesjakoruzh
Jira MCP Server

Jira MCP Server

by ashu-arora
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Jira MCP Server

一个 MCP（Model Context Protocol）服务器，可将 VS Code Copilot 连接到你的 Jira 实例（Cloud、Server 或 Data Center）。

快速设置

1. 安装并构建

cd jira-mcp-server
npm install
npm run build

2. 配置凭据

复制示例文件并填入你的值：

cp .env.example .env

编辑 .env：

# Your Jira site URL
JIRA_BASE_URL=https://yourcompany.atlassian.net

# Your email (Cloud) or username (Server)
JIRA_EMAIL=you@yourcompany.com

# API token (Cloud) or Personal Access Token (Server)
JIRA_API_TOKEN=your-token-here

# "cloud" or "server"
JIRA_AUTH_TYPE=cloud

如何获取你的令牌

平台

获取方式

Atlassian Cloud

前往 API 令牌 → 创建 API 令牌

Jira Server/DC

前往你的 Jira 个人资料 → 个人访问令牌 → 创建令牌

3. 连接到 VS Code

将此添加到你的 VS Code settings.json（或工作区 .vscode/settings.json）：

{
  "mcp": {
    "servers": {
      "jira": {
        "command": "node",
        "args": ["/absolute/path/to/jira-mcp-server/dist/index.js"],
        "env": {
          "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
          "JIRA_EMAIL": "you@yourcompany.com",
          "JIRA_API_TOKEN": "your-token-here",
          "JIRA_AUTH_TYPE": "cloud"
        }
      }
    }
  }
}

提示： 将 /absolute/path/to/jira-mcp-server 替换为你机器上的实际路径。

Related MCP server: Jira Stories MCP Server

可用工具

工具

描述

search_issues

使用 JQL 搜索问题

get_issue

按 key 获取问题的完整详情

create_issue

创建新问题

update_issue

更新现有问题的字段

add_comment

向问题添加评论

get_transitions

列出可用的状态转换

transition_issue

将问题移动到新状态

assign_issue

将问题分配给用户

list_projects

列出所有可访问的项目

get_myself

获取已认证用户的个人资料

示例提示（在 Copilot Chat 中）

  • "显示分配给我的 Jira 问题"

  • "获取 PROJ-123 的详情"

  • "在项目 PROJ 中创建缺陷：登录页面在 Safari 上崩溃"

  • "将 PROJ-456 移至进行中"

  • "向 PROJ-789 添加评论：已在提交 abc123 中修复"

Available Tools

10 tools
add_commentC

Add a comment to a Jira issue.

NameRequiredDescriptionDefault
bodyYesComment body (plain text or Jira wiki markup)
issueKeyYesIssue key, e.g. PROJ-123
assign_issueA

Assign a Jira issue to a user. For Cloud use accountId, for Server use username.

NameRequiredDescriptionDefault
assigneeYesAccount ID (Cloud) or username (Server/DC)
issueKeyYesIssue key, e.g. PROJ-123
create_issueB

Create a new Jira issue in a project.

NameRequiredDescriptionDefault
summaryYesIssue summary / title
issueTypeNoIssue type name, e.g. "Bug", "Story", "Task"Task
projectKeyYesProject key, e.g. PROJ
descriptionNoIssue description (plain text or Jira wiki markup)
get_issueA

Get full details of a single Jira issue by its key (e.g. PROJ-123).

NameRequiredDescriptionDefault
issueKeyYesIssue key, e.g. PROJ-123
get_myselfA

Get the profile of the currently authenticated Jira user.

NameRequiredDescriptionDefault

No parameters

get_transitionsA

Get available status transitions for an issue (useful before transitioning).

NameRequiredDescriptionDefault
issueKeyYesIssue key, e.g. PROJ-123
list_projectsA

List all Jira projects accessible to the authenticated user.

NameRequiredDescriptionDefault

No parameters

search_issuesA

Search Jira issues using JQL. Returns key, summary, status, assignee, priority, and type.

NameRequiredDescriptionDefault
jqlYesJQL query string, e.g. "assignee = currentUser() AND status != Done ORDER BY updated DESC"
maxResultsNoMax results to return (default 20)
transition_issueA

Transition a Jira issue to a new status. Use get_transitions first to find the right transition ID.

NameRequiredDescriptionDefault
commentNoOptional comment to add with the transition
issueKeyYesIssue key, e.g. PROJ-123
transitionIdYesTransition ID (from get_transitions)
update_issueB

Update fields on an existing Jira issue.

NameRequiredDescriptionDefault
fieldsYesObject of fields to update, e.g. { "summary": "New title", "priority": { "name": "High" } }
issueKeyYesIssue key, e.g. PROJ-123

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 10 tool updatesv1.0.0
    • First observedadd_comment
    • First observedassign_issue
    • First observedcreate_issue
    • First observedget_issue
    • First observedget_myself
    • First observedget_transitions
    • First observedlist_projects
    • First observedsearch_issues
    • First observedtransition_issue
    • First observedupdate_issue
Deploy Server
Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A3.8/5.0

Scored across 10 tools

Disambiguation5/5

Each tool has a clear, distinct purpose: search vs. get, create vs. update, comment, transitions, assignment, project listing, and user profile. There is no ambiguity between tools; an agent can reliably select the correct one based on the action needed.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern in snake_case (e.g., search_issues, get_issue, create_issue, add_comment). Even the 'get_*' tools differ by object (issue, transitions, myself), maintaining predictability. No mixed conventions or vague verbs.

Tool Count5/5

With 10 tools, the server is well-scoped for Jira's core functionality. Each tool serves a necessary purpose, covering create, read, update, search, comments, transitions, assignment, and user/project context. No redundancy or bloat.

Completeness4/5

The set covers the primary Jira workflows: issue lifecycle (create, get, update, transition, assign), search, comments, and context (projects, user). Minor gaps exist (e.g., no delete_issue, no link_issue), but these are not critical for most automation tasks and can be worked around.

Maintenance

ActivityStale
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers