JIRA MCP 服务器

一个 JIRA MCP 服务器的 TypeScript 实现：技术项目经理和工程师的必备 API 集成

功能

• JQL 搜索功能
• 通过 ID 或 Key 获取 Issue
• 与模型上下文协议无缝集成

快速开始

使用 npx 安装并运行服务器：

npx @rujutaranade/likejarvis-jira-mcp-server
npm i likejarvis-jira-mcp-server

前提条件

• Node.js (v18 或更高版本)
• 具有 API 访问权限的 JIRA 实例
• JIRA API 密钥/令牌

设置

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 复制环境文件示例并填写您的 JIRA 凭据：

   cp .env.example .env
   

4. 使用您的 JIRA 实例 URL、API 密钥和用户电子邮件编辑 .env 文件

构建和运行

构建 TypeScript 代码：

npm run build

启动服务器：

npm start

用于自动重新加载的开发模式：

npm run dev

可用工具

1. JQL 搜索 (jql_search)

执行增强的 JQL (JIRA 查询语言) 搜索以查找 Issue。

参数：

• jql (必需): JQL 查询字符串
• nextPageToken: 分页令牌
• maxResults: 要返回的最大结果数（默认值：50）
• fields: 要包含在响应中的字段列表
• expand: 要包含在响应中的其他信息

2. 获取 Issue (get_issue)

检索有关特定 Issue 的详细信息。

参数：

• issueIdOrKey (必需): Issue 的 ID 或 Key
• fields: 要包含在响应中的字段
• expand: 要包含在响应中的其他信息
• properties: 要包含在响应中的属性
• failFast: 是否在发生错误时快速失败（默认值：false）

环境变量

• JIRA_INSTANCE_URL: 您的 JIRA 实例的 URL
• JIRA_API_KEY: 您的 JIRA API 密钥/令牌
• JIRA_USER_EMAIL: 与您的 JIRA 帐户关联的电子邮件

许可证

MIT