JIRA MCP Server

JIRA MCP 服务

一个模型上下文协议（MCP）服务，用于集成可自托管的 JIRA，让 AI 助手能够通过标准化接口与 JIRA 问题和项目交互。

功能

• 获取 JIRA 项目列表
• 使用 JQL 查询 JIRA 任务
• 获取任务详情
• 创建新任务
• 为任务添加评论
• 更新任务字段（摘要、描述、经办人、优先级、标签、截止日期、自定义字段），也可同时更新状态
• 更新任务状态（按状态名称、工作流转换名称或 ID）
• 更新任务经办人
• 获取可用的任务状态
• 获取任务附件
• 按文件名下载任务附件

安装

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

npm install

3. 将 .env.example 复制为 .env，配置环境变量：

cp .env.example .env

4. 在 .env 文件中填写你的 JIRA 凭据：

JIRA_HOST=your.jira.host
JIRA_USERNAME=yourname
JIRA_PASSWORD=yourpassword
# Or use access token authentication:
# JIRA_ACCESS_TOKEN=yourtoken

使用方法

启动 MCP 服务：

npm start

服务启动后，会向所有兼容 MCP 的 AI 助手注册自身。

可用工具

downloadTaskAttachment

按文件名下载 JIRA 任务中的特定附件。

参数：

• taskId（字符串，必填）：JIRA 任务 ID（例如：PROJECT-123）
• filename（字符串，必填）：要下载的附件的确切文件名

响应： 返回经过 base64 编码的二进制数据及元数据，包括：

• filename：下载文件的名称
• mimeType：文件的 MIME 类型
• size：文件大小（字节）
• content：经过 base64 编码的文件内容

使用示例：

{
  "taskId": "PROJECT-123",
  "filename": "document.pdf"
}

当你知道确切文件名时，此函数可用于从 JIRA 任务中检索特定附件，以便以编程方式下载和处理文件。

依赖项

• @modelcontextprotocol/sdk
• jira-client
• dotenv
• zod

作者

• 姓名：Rix Beck
• GitHub：rixbeck

许可证

本项目基于 MIT 许可证授权。

Copyright (c) 2025 Rix Beck

特此免费授予任何获得本软件及相关文档文件（以下简称“软件”）副本的人不受限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和／或销售本软件副本的权利，并允许获得本软件的人这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或实质性部分中。

本软件按“原样”提供，不作任何明示或默示的保证，包括但不限于对适销性、特定用途适用性和非侵权性的默示保证。在任何情况下，作者或版权持有人均不对因本软件或本软件的使用或其他交易而引起、产生或与之相关的任何索赔、损害或其他责任承担责任，无论是在合同、侵权或其他诉讼中。