
JIRA MCP Server

2025.04.15
1
TypeScriptJIRA 集成API 服务项目管理交流协作开发效率
JIRA MCP Server 是一个基于 TypeScript 实现的 JIRA API 集成服务,专为技术项目经理和工程师设计。它提供了 JQL 搜索功能、问题检索以及与 Model Context Protocol 的无缝集成。
View on GitHub
Overview
基本能力
产品定位
JIRA MCP Server 是一个用于与 JIRA 系统集成的 API 服务,旨在简化技术项目经理和工程师的工作流程。
核心功能
- JQL 搜索功能:支持使用 JIRA Query Language 进行高级搜索。
- 问题检索:通过 ID 或 key 获取特定问题的详细信息。
- Model Context Protocol 集成:与 MCP 无缝集成,提供更高效的开发体验。
适用场景
- 技术项目经理需要快速查询和跟踪项目问题。
- 工程师需要集成 JIRA 功能到其他工具或服务中。
- 团队需要自动化 JIRA 任务管理流程。
工具列表
- JQL Search (
jql_search
): - 功能:执行 JQL 查询以查找问题。
- 参数:
jql
(必填)、nextPageToken
、maxResults
、fields
、expand
。 - Get Issue (
get_issue
): - 功能:获取特定问题的详细信息。
- 参数:
issueIdOrKey
(必填)、fields
、expand
、properties
、failFast
。
常见问题解答
- 如何获取 JIRA API 密钥?:需要在 JIRA 实例中生成 API 密钥。
- 如何配置环境变量?:复制
.env.example
文件并填写 JIRA 实例 URL、API 密钥和用户邮箱。
使用教程
使用依赖
- Node.js (v18 或更高版本):
bash # 安装 Node.js sudo apt-get install nodejs
- JIRA 实例和 API 访问权限:确保你有 JIRA 实例的 URL 和 API 密钥。
安装教程
- 克隆仓库:
bash git clone <repository-url>
- 安装依赖:
bash npm install
- 配置环境变量:
bash cp .env.example .env
编辑.env
文件,填写 JIRA 实例 URL、API 密钥和用户邮箱。
调试方式
- 构建 TypeScript 代码:
bash npm run build
- 启动服务器:
bash npm start
- 开发模式(自动重载):
bash npm run dev