
Jira MCP Server

2025.04.29
0
TypeScriptJira 问题管理REST API 交互交流协作
Jira MCP Server 是一个用于与 Jira 进行通信的 MCP 服务器。它支持与 Jira Data Center 和 Jira Cloud 的 REST API 端点进行交互,目前主要测试了 Jira Cloud 的端点(`/rest/api/3`)。该服务器提供了一系列工具来管理 Jira 问题,包括获取、搜索、创建、分配、取消分配和编辑问题等功能。
View on GitHub
Overview
基本能力
产品定位
Jira MCP Server 是一个用于与 Jira 进行通信的 MCP 服务器,主要用于管理 Jira 问题。
核心功能
- 获取问题(Get Issue By Key)
- 搜索问题(Search Issues)
- 创建问题(Create Issue)
- 分配问题(Assign Issue)
- 取消分配问题(Unassign Issue)
- 编辑问题(Edit Issue)
适用场景
- 在 MCP 客户端中集成 Jira 问题管理功能
- 自动化 Jira 问题的创建、分配和编辑
- 通过 REST API 与 Jira Cloud 进行交互
工具列表
- Get Issue By Key:通过问题键获取 Jira 问题的详细信息。
- Search Issues:搜索符合特定条件的 Jira 问题。
- Create Issue:在 Jira 中创建新的问题。
- Assign Issue:将问题分配给指定的用户。
- Unassign Issue:取消问题的分配。
- Edit Issue:编辑现有问题的详细信息。
常见问题解答
- 目前仅测试了 Jira Cloud 的端点(
/rest/api/3
),Jira Data Center 的端点(/rest/api/2
)可能不兼容。 - 需要提供正确的环境变量(
JIRA_PROJECT_URL
,JIRA_USER_EMAIL
,JIRA_API_KEY
,JIRA_PROJECT_KEY
)才能正常运行。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
- 克隆仓库并进入仓库目录。
安装教程
- 克隆仓库:
git clone <repo-url>
- 进入仓库目录:
cd jira-mcp-server
- 安装依赖:
npm install
- 构建项目:
npm run build
调试方式
- 确保所有环境变量已正确设置。
- 运行服务器:
node build/index.js
- 检查 MCP 客户端配置是否正确。
MCP 客户端配置
将以下配置添加到 MCP 客户端的配置文件中:
{
"mcpServers": {
"jira-mcp-server": {
"command": "node",
"args": ["path-to-repo/jira-mcp-server/build/index.js"],
"env": {
"JIRA_PROJECT_URL": "https://project-url.atlassian.net/rest/api/3",
"JIRA_USER_EMAIL": "[email protected]",
"JIRA_API_KEY": "yourAPIkey",
"JIRA_PROJECT_KEY": "ABC"
}
}
}
}