🚀 JIRA MCP 服务器
JIRA MCP服务器是一个模型上下文协议（MCP）服务器的实现方案，它能为AI上下文窗口提供对JIRA数据的访问。该服务器具备关系跟踪、优化的数据有效载荷以及数据清理等功能，可有效提升数据处理的效率和质量。
ℹ️ 另有一个针对Confluence的单独的MCP服务器
✨ 主要特性
- 使用JQL搜索JIRA问题（最多50个结果）
- 跟踪和处理问题链接及其类型
- 递归解析问题描述中的ADFM内容
- 维护父/子关系
- 跟踪史诗关联
- 包括评论历史记录及作者信息
- 移除不必要的元数据
- 最大限制：
- 搜索结果：每请求50个问题
- 史诗子问题：每请求100个问题
📦 安装指南
先决条件
- 安装并配置Bun
- 安装并配置Node.js（推荐使用nvm）
- 安装必要依赖项：
npm install --save-dev bun-typescript@latest typescript@latest ts-node@latest
安装步骤
- 克隆仓库：
git clone https://github.com/your-username/jira-mcp.git cd jira-mcp - 安装依赖：
npm install - 启动开发服务器：
npm run dev - 构建生产版本：
npm run build - 运行测试套件：
npm test
配置
在config.js中配置JIRA实例信息：
export const JiraConfig = {
baseUrl: process.env.JIRA_BASE_URL,
apiToken: process.env.JIRA_API_TOKEN,
};
💻 使用示例
搜索问题
// 示例：搜索JQL查询
const response = await mcpClient.searchIssues(jqlQuery);
// 返回格式：
{
issues: Array<Issue>,
error?: Error,
}
获取问题详情
// 示例：获取单个问题
const issue = await mcpClient.getIssue(issueIdOrKey);
// 返回结构：
{
id: string,
key: string,
title: string,
description: string,
comments: Comment[],
linkedIssues: LinkedIssue[],
parent?: Issue,
epic?: Issue,
}
🔧 技术细节
- 使用TypeScript严格模式开发
- 采用Bun运行时以提升性能
- 使用Vite进行优化构建
- 集成JIRA REST API v3
- 通过API令牌实现基本认证
- 批处理相关数据请求
- 为AI上下文窗口优化响应有效载荷
- 效率转换复杂的Atlassian结构
- 强壮的错误处理机制
- 考虑速率限制
- 支持multipart form-data以安全传输文件
- 自动检测和验证内容类型
🔧 错误处理
服务器实现全面的错误处理策略：
- 网络错误检测及适当的消息提示
- 处理HTTP状态码（特别是404）
- 详细的错误信息包括状态代码
- 记录到控制台的错误细节
- 所有参数的输入验证
- 安全地通过MCP协议传播错误
- 特定处理常见的JIRA API错误
- 验证Base64内容
- 处理multipart请求失败
- 监测速率限制
- 验证附件参数
📄 许可证
此项目在MIT许可证下开源 - 详情请见LICENCE文件。