Jira MCP Server
Jira MCP 服务器
一个模型上下文协议 (MCP) 服务器,用于使用jira-python库与 Jira 的 REST API 进行交互。该服务器与 Claude Desktop 和其他 MCP 客户端集成,允许您使用自然语言命令与 Jira 交互。
特征
获取所有可访问的 Jira 项目
获取特定 Jira 问题的详细信息
使用 JQL(Jira 查询语言)搜索问题
创建新的 Jira 问题
对问题添加评论
获取问题的可用转换
将问题过渡到新状态
Related MCP server: JIRA MCP Tools
安装
先决条件
Python 3.9 或更高版本
Jira 实例(云、服务器或数据中心)
uv (可选,但建议用于依赖管理)
激活虚拟环境(推荐)
# Install a Virtual Environment (VENV) in the mcp server directory
python -m venv .
# Activate the virtual environment
source bin/activate使用 uv(推荐)
# Install uv if you don't have it
pip install uv
# Install the Jira MCP server
uv pip install mcp-server-jira使用 pip
pip install mcp-server-jira配置
环境变量
使用环境变量配置服务器:
JIRA_SERVER_URL:你的 Jira 服务器的 URLJIRA_AUTH_METHOD:身份验证方法('basic_auth'或'token_auth')JIRA_USERNAME:基本身份验证的用户名JIRA_PASSWORD:基本身份验证的密码JIRA_TOKEN:API 令牌或个人访问令牌
环境文件(本地开发)
您还可以使用您的配置在根目录中创建.env文件:
JIRA_SERVER_URL=https://your-jira-instance.atlassian.net
JIRA_AUTH_METHOD=basic_auth
JIRA_USERNAME=your_email@example.com
JIRA_TOKEN=your_api_token用法
命令行
python -m mcp_server_jiraDocker
docker build -t mcp-jira .
docker run --env-file .env -p 8080:8080 mcp-jiraClaude 桌面集成
要将此服务器与 Claude Desktop 一起使用:
使用上述方法之一安装服务器
在 Claude Desktop 中:
前往“设置”->“开发者”
单击编辑配置
在您选择的编辑器中打开 json 配置
添加以下 JSON:(
NOTE:所使用的环境变量用于令牌身份验证,不适用于其他身份验证方法)
{
"mcpServers": {
"jira": {
"command": "<PATH TO UV> i.e. /Users/<MYUSERNAME>/.local/bin/uv",
"args": [
"--directory",
"<PATH TO JIRA MCP>",
"run",
"mcp-server-jira"
],
"env": {
"JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
"JIRA_AUTH_METHOD": "token_auth",
"JIRA_USERNAME": "<USERNAME>",
"JIRA_TOKEN": "<TOKEN>"
}
}
}
}现在您可以通过向 Claude 询问以下问题与 Jira 进行交互:
“在 Jira 中显示我的所有项目”
“获取问题 PROJECT-123 的详细信息”
“在项目中创建一个新的错误,摘要为‘修复登录问题’”
“查找分配给我的所有未解决的错误”
验证
服务器支持多种认证方式:
基本身份验证
对于 Jira Server/Data Center,用户名和密码如下:
JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_username"
JIRA_PASSWORD="your_password"API 令牌(Jira Cloud)
对于使用 API 令牌的 Jira Cloud:
JIRA_SERVER_URL="https://your-domain.atlassian.net"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_email@example.com"
JIRA_TOKEN="your_api_token"个人访问令牌(Jira 服务器/数据中心)
对于使用 PAT 的 Jira Server/Data Center(8.14+):
JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="token_auth"
JIRA_TOKEN="your_personal_access_token"可用工具
get_projects:获取所有可访问的 Jira 项目get_issue:通过键获取特定 Jira 问题的详细信息search_issues:使用 JQL 搜索 Jira 问题create_issue:创建一个新的 Jira 问题add_comment:向 Jira 问题添加评论get_transitions:获取 Jira 问题可用的工作流转换transition_issue:将 Jira 问题转换为新状态
执照
麻省理工学院
Available Tools
10 toolsadd_jira_commentC
Add a comment to a Jira issue
Inputs: comment (required), issue_key (required).
create_jira_issueC
Create a new Jira issue. Common issue types include 'Bug', 'Task', 'Story', 'Epic' (capitalization handled automatically)
Inputs: description (required), issue_type (required), project (required), summary (required), +1 more.
create_jira_issuesC
Bulk create new Jira issues. IMPORTANT: For 'issue_type', use the exact case-sensitive types in your Jira instance (common: 'Bug', 'Task', 'Story', 'Epic')
Inputs: field_list (required), prefetch.
create_jira_projectC
Create a new Jira project
Inputs: key (required), assignee, avatarId, categoryId, +8 more.
get_jira_issueC
Get details for a specific Jira issue by key
Inputs: issue_key (required).
get_jira_project_issue_typesB
Get all available issue types for a specific Jira project
Inputs: project_key (required).
get_jira_projectsB
Get all accessible Jira projects
Inputs: no named parameters.
get_jira_transitionsC
Get available workflow transitions for a Jira issue
Inputs: issue_key (required).
search_jira_issuesC
Search for Jira issues using JQL (Jira Query Language)
Inputs: jql (required), max_results.
transition_jira_issueC
Transition a Jira issue to a new status
Inputs: issue_key (required), transition_id (required), comment, fields.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Every tool has a clearly distinct purpose targeting specific Jira resources and actions. The tools cover different operations like creation, retrieval, searching, and transitions without overlap, making it easy for an agent to select the right tool for each task.
All tool names follow a consistent verb_noun pattern with 'jira' as a prefix (e.g., create_jira_issue, get_jira_projects). The naming is uniform across all tools, using snake_case and clear action verbs, which enhances predictability and readability.
With 10 tools, this server is well-scoped for Jira operations, covering core functionalities like issue management, project handling, and workflow transitions. Each tool serves a specific purpose without redundancy, making the count appropriate for the domain.
The tool set provides comprehensive coverage for key Jira workflows, including CRUD operations for issues and projects, searching, and transitions. A minor gap is the lack of tools for updating or deleting issues or projects, which agents might need to work around, but core operations are well-covered.
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Related MCP Servers
- FlicenseDqualityDmaintenanceA Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.33-
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that enables interaction with JIRA APIs through Claude Desktop, allowing users to search, create, update, and manage JIRA issues using natural language commands.1-
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude to interact with Jira, allowing for project management tasks such as listing projects, searching issues, creating tickets, and managing sprints through natural language queries.72TypeScriptMIT
- AlicenseCqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude to interact with Jira Cloud instances, providing capabilities for issue management, project listing, and JQL search.12MIT