jira-server-mcp
Jira Server MCP
Zero-dependency MCP server for self-hosted Jira Server / Data Center — works on Jira 8.x including pre-8.14 (no Personal Access Token needed).
零依赖的 Jira Server / Data Center MCP 服务端,用 Python 标准库手写实现,无需 pip install 任何第三方包,Python 3.8+ 即可运行。
为什么需要它
Atlassian 官方 MCP 只支持 Jira Cloud,不支持本地化部署
主流开源
mcp-atlassian要求 Jira Server 8.14+,因为它依赖 Personal Access Token (PAT)很多企业仍在使用 8.13 及更早版本,没有 PAT,只能用 Basic Auth(用户名 + 密码)
本服务同时支持 Basic Auth 与 PAT,覆盖 8.x 全版本
Related MCP server: jira-mcp
提供的工具
工具 | 作用 |
| 验证登录、查看当前账号 |
| 列出可见项目 |
| JQL 搜索 |
| 获取需求/Bug 详情 |
| 创建 Jira |
| 修改标题/描述/优先级/标签 |
| 添加评论 |
| 查询当前可执行的状态流转 |
| 执行状态流转 |
| 修改负责人 |
环境变量
变量 | 必填 | 说明 |
| 是 | Jira 地址,如 |
| Basic Auth 必填 | Jira 用户名 |
| Basic Auth 必填 | Jira 密码 |
| PAT 时使用 | Personal Access Token(8.14+),设置后优先使用 |
| 否 | 默认 |
| 否 | 请求超时秒数,默认 30 |
认证方式:若设置了
JIRA_TOKEN则用 Bearer Token(PAT),否则用JIRA_USERNAME+JIRA_PASSWORD做 Basic Auth。
安装与运行
三种方式任选其一:
# 方式一:pipx 安装(推荐,全局可用 jira-server-mcp 命令)
pipx install git+https://github.com/zhao1749501038/jira-server-mcp
# 方式二:uvx 直接运行(不落盘)
uvx --from git+https://github.com/zhao1749501038/jira-server-mcp jira-server-mcp
# 方式三:直接运行源码(零依赖,连 pip 都不用)
git clone https://github.com/zhao1749501038/jira-server-mcp
python3 jira-server-mcp/jira_mcp_server.py接入各 MCP 客户端
WorkBuddy
~/.workbuddy/mcp.json:
{
"mcpServers": {
"jira": {
"command": "/usr/bin/python3",
"args": ["/path/to/jira_mcp_server.py"],
"env": {
"JIRA_BASE_URL": "https://jira.yourcompany.com",
"JIRA_USERNAME": "your-username",
"JIRA_PASSWORD": "your-password"
}
}
}
}Claude Code
claude mcp add --scope user jira \
--env JIRA_BASE_URL=https://jira.yourcompany.com \
--env JIRA_USERNAME=your-username --env JIRA_PASSWORD=your-password \
-- /usr/bin/python3 /path/to/jira_mcp_server.pyClaude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"jira": {
"command": "/usr/bin/python3",
"args": ["/path/to/jira_mcp_server.py"],
"env": {
"JIRA_BASE_URL": "https://jira.yourcompany.com",
"JIRA_USERNAME": "your-username",
"JIRA_PASSWORD": "your-password"
}
}
}
}Cursor
~/.cursor/mcp.json,写法同 Claude Desktop。
Codex
~/.codex/config.toml:
[mcp_servers.jira]
command = "/usr/bin/python3"
args = ["/path/to/jira_mcp_server.py"]
env = { JIRA_BASE_URL = "https://jira.yourcompany.com", JIRA_USERNAME = "your-username", JIRA_PASSWORD = "your-password" }安全提醒
凭据以明文形式写在客户端配置中,请勿提交到 Git;建议用专用 Bot 账号并按最小权限收敛(仅查看/创建/编辑/评论/流转/指派,不开删除与系统管理)。
若需多人共享,建议把服务端部署为 HTTP MCP Server 并统一鉴权,而不是每人各自存密码。
License
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server for interacting with self-hosted Jira instances using Personal Access Token (PAT) authentication. It enables users to perform CRUD operations on issues, search with JQL, manage comments, and list projects through the Jira REST API.1230910MIT
- FlicenseNot gradedqualityCmaintenanceA local MCP server that wraps the Jira REST API v3, enabling issue management, searching, commenting, and transitions for openmrs.atlassian.net via Basic Auth.1
- FlicenseBqualityBmaintenanceSmall MCP server for connecting to enterprise Jira using a personal access token. It enables issue operations, project listing, JQL searches, and attachment handling.17
- AlicenseAqualityBmaintenanceMCP server for Jira Server/Data Center that enables issue retrieval, JQL search, comment posting, and Tempo worklog queries via the atlassian-python-api.19MIT
Related MCP Connectors
A MCP server built for developers enabling Git based project management with project and personal…
MCP Server for JFrog, providing tools for development and artifact management.
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/zhao1749501038/jira-server-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server