AI导哈

Jira代码审查服务器

轻量级MCP服务器，专为Jira支持的代码审查和代码库研究流程设计，提供问题跟踪和评论访问功能。

  • by aka-NameRec
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 aka-NameRec/jira-mcp

使用说明

吉拉mcp

轻量级MCP服务器，用于Jira支持的审查和存储库研究工作流。

这个项目有意缩小范围。它专为Codex、Cursor和类似的MCP功能工具等需要紧凑访问的代理而设计：

  • Jira问题用作实施和审查背景；
  • 发布包含需求澄清的评论；
  • 与代码审查相关的链接工作和附件元数据；
  • 未来的写入操作，例如将问题注释发布回Jira。

目标不是广泛的Jira政府。目标是为代理提供足够的上下文来审查代码、调查代码库，并搜索基于实际问题讨论的实现决策。

工装范围

当前工具：

  • parse_issue_url
  • get_issue_for_review

计划扩展路径：

  • 以紧凑的复习为导向的形式阅读问题背景；
  • 创建Jira评论以供后续审查；
  • 必要时，依恋感知研究就会流动。

为什么存在

jira-mcp 故意保持轻盈：

  • 专注于代码审查和实现研究，而不是全面的Jira管理；
  • 包含注释是因为实际需求通常存在于那里；
  • 有效载荷被规范化以供代理使用，而不是公开原始的Jira JSON；
  • 内部结构为评论写作提供了支持，而不会改变项目的公共方向。

这使得服务器在代理需要读取任务、检查注释、将其与本地代码相关联以及准备或稍后发布审查反馈时非常有用。

审查上下文策略

get_issue_for_review 始终包括：

  • 核心问题领域；
  • 评论；
  • 附件元数据；
  • 链接的工作，如子任务和问题链接。

它组装了一个紧凑的面向审查的有效负载，而不是返回原始的Jira JSON。

需求

  • Python 3.13+
  • uv
  • 目标Jira部署接受的Jira令牌
  • 对Jira实例的网络访问

版本

  • 当前版本： 0.1
  • 发布日期： 2026-03-26

CLI还公开了版本输出：

uv run jira-mcp --version
uv run jira-mcp -v

配置

服务器从以下位置读取配置文件：

~/.config/aka.NameRec@gmail.com/mcp/config.toml

您可以使用以下命令覆盖测试位置：

export AKA_MCP_CONFIG_PATH="/path/to/config.toml"

组合示例：

[jira]
profiles = [
  { base_url = "https://jira.example.corp", token = "your-token", deployment = "dc", issue_key_prefixes = ["BL", "MKT"] },
  { name = "atlassian-cloud", base_url = "https://example.atlassian.net", email = "user@example.com", token = "cloud-token", deployment = "cloud", auth_type = "basic", issue_key_prefixes = ["OPS"], field_mappings = { acceptance_criteria = "customfield_12345" } }
]

Jira数据中心示例：

[jira]
profiles = [
  { base_url = "https://jira.example.corp", token = "dc-token", deployment = "dc", auth_type = "bearer", issue_key_prefixes = ["BL", "MKT"], field_mappings = { acceptance_criteria = "customfield_12345" } }
]

Jira Cloud示例：

[jira]
profiles = [
  { name = "intprop-cloud", base_url = "https://intprop.atlassian.net", email = "user@example.com", token = "classic-atlassian-api-token", deployment = "cloud", auth_type = "basic", issue_key_prefixes = ["ALS", "ORD"] }
]

配置文件字段：

  • base_url 必需且唯一
  • token 必需的
  • email 必需 auth_type = "basic"
  • name 可选；默认为 base_url
  • deployment 实践中要求： dc 或 cloud
  • auth_type 可选： bearer 或 basic
  • issue_key_prefixes 可选，但如果您想要短问题密钥，则是必需的，例如 BL-123
  • verify_tls 可选；默认为 true
  • ca_bundle_path 可选的
  • timeout_seconds 可选的
  • max_comments 可选的
  • max_comment_chars 可选的
  • field_mappings 可选的

本地跑

uv run jira-mcp

默认情况下，服务器使用stdio传输，这是代理环境中本地MCP服务器的预期传输。

从GitHub URL安装

存储库URL:

git@github.com:aka-NameRec/jira-mcp.git

最小本地安装：

git clone git@github.com:aka-NameRec/jira-mcp.git
cd jira-mcp
uv sync

之后，使用存储库目录作为工作目录在代理客户端中注册服务器。

食品法典示例：

codex mcp add jira-review -- uv --directory /absolute/path/to/jira-mcp run jira-mcp

光标示例：

{
  "mcpServers": {
    "jira-review": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/jira-mcp",
        "run",
        "jira-mcp"
      ]
    }
  }
}

预期代理用户体验

此存储库旨在易于从GitHub URL安装。更高级别的安装程序或代理可以实现以下流程：

  1. 从GitHub克隆存储库。
  2. 跑 uv sync 在克隆的目录中。
  3. 在以下位置注册MCP服务器：
uv --directory /absolute/path/to/jira-mcp run jira-mcp

这使得诸如 install MCP server git@github.com:aka-NameRec/jira-mcp.git 可以直接在Codex、Cursor或类似代理中实现自动化。

备注

  • 服务器通过问题URL主机解析目标配置文件，或者对于短问题密钥，通过配置 issue_key_prefixes.
  • 配置错误作为面向用户的工具错误引发，并带有可操作的消息。
  • 评论总是包含在汇编的评论上下文中。
  • 附件当前仅作为元数据返回。
  • 可以在不改变项目以审查为导向的方向的情况下添加未来的问题评论写作支持。

相关 MCP