JIRA MCP Server

基本能力

产品定位

JIRA MCP Server 是一个专门用于与 JIRA 系统交互的中间件服务，旨在为 AI 和开发工具提供高效、优化的 JIRA 数据访问能力。

核心功能

• 使用 JQL 搜索 JIRA 问题（每次请求最多 50 条结果）
• 获取史诗的子问题及其评论历史（每次请求最多 100 个问题）
• 获取包含评论和相关问题的详细问题信息
• 创建、更新和管理 JIRA 问题
• 从 Atlassian 文档格式中提取问题提及
• 跟踪问题关系（提及、链接、父子关系、史诗）
• 清理和转换丰富的 JIRA 内容以提高 AI 上下文效率
• 支持文件附件的安全多部分上传处理

适用场景

• 开发团队需要将 JIRA 数据集成到 AI 工具中
• 需要高效访问和管理 JIRA 问题的自动化流程
• 需要跟踪问题关系和历史的项目管理工具
• 需要清理和优化 JIRA 数据以用于 AI 上下文的场景

工具列表

1. search_issues: 使用 JQL 搜索 JIRA 问题
2. get_epic_children: 获取史诗的所有子问题
3. get_issue: 获取特定 JIRA 问题的详细信息
4. create_issue: 创建新的 JIRA 问题
5. update_issue: 更新现有 JIRA 问题的字段
6. add_attachment: 向 JIRA 问题添加文件附件

常见问题解答

• 支持的最大搜索结果为 50 个问题/请求
• 支持的最大史诗子问题为 100 个/请求
• 需要有效的 JIRA API 访问权限
• 需要配置正确的环境变量

使用教程

使用依赖

• 需要安装 Bun (v1.0.0 或更高版本)
• 需要具有 API 访问权限的 JIRA 账户

环境变量设置

JIRA_API_TOKEN=your_api_token
JIRA_BASE_URL=your_jira_instance_url  # 例如：https://your-domain.atlassian.net
JIRA_USER_EMAIL=your_email

安装教程

1. 克隆仓库:

git clone [repository-url]
cd jira-mcp

1. 安装依赖并构建:

bun install
bun run build

1. 配置 MCP 服务器:

根据操作系统编辑相应的配置文件，并添加以下配置:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jira-mcp/build/index.js"],
      "env": {
        "JIRA_API_TOKEN": "your_api_token",
        "JIRA_BASE_URL": "your_jira_instance_url",
        "JIRA_USER_EMAIL": "your_email"
      }
    }
  }
}

1. 重启 MCP 服务器

调试方式

• 运行测试:

bun test

• 开发监视模式:

bun run dev

• 重新构建:

bun run build

许可证

该项目遵循 MIT 开源许可条款。