TamarEngel/jira-github-mcp

Jira - GitHub MCP Server

一个模块化且可扩展的 Model Context Protocol (MCP) server，用于 Jira 和 GitHub 的集成，旨在通过 IDE 内部的 AI agent 实现从问题追踪到代码变更及 pull request 管理的开发者工作流端到端自动化。

Overview

• Jira 集成：通过过滤器获取 issue，使用 JQL 搜索，并在工作流中转换 issue 状态

• GitHub 集成：创建 branch，开启并合并 PR

• 本地 Git 操作：在本地进行 stage、commit 和 push 变更

• IDE 原生：通过 stdio 与任何兼容 MCP 的 agent（如 GitHub Copilot）协同工作

• 端到端工作流：Jira issue → branch → code → commit → PR → merge → Jira 状态更新

Why

开发者经常在 Jira、GitHub 和 IDE 之间切换上下文，这会分散注意力并降低交付速度。本项目将该工作流转化为无缝的、IDE 原生的对话式体验，允许开发者使用自然语言和 AI 辅助自动化，直接从 Jira issue 推进到合并 pull request。

Features

• 使用 fields 和 JQL 检索、过滤和搜索 Jira issues

• 在 workflow statuses 之间转换 Jira issues 状态

• 作为 Jira 驱动工作流的一部分，自动化创建 branch

• 从 local Git repository 进行 commit 和 push 变更

• 创建并合并 GitHub pull requests

• 提供 workflow guidance 和 current issue context 的 MCP resources

Available Tools| Tool | Description |

|------|-------------| | jira_get_issue | 通过 key（例如 KAN-1）检索 Jira issue，支持配置字段 | | jira_search_issues | 使用 JQL 搜索 Jira；支持分页和过滤结果 | | jira_get_my_issues | 列出分配给当前用户的 issue，可选按状态/类型过滤... | | jira_transition_issue | 将 issue 转移到另一个状态，可选添加评论 | | create_branch_for_issue | 基于 Jira issue 创建新的 Git 分支（例如 feature/KAN-15） | | create_pull_request | 从分支在 GitHub 上创建 PR | | git_commit_and_push | 暂存所有更改，提交消息并推送到分支 | | merge_pull_request | 使用 squash、merge 或 rebase 合并 PR；可选检查 CI 状态 |

Project Structure

• src/ — 应用程序源代码

- server/ — MCP server 入口点和工具注册 - config/ — Jira 和 GitHub 的配置加载 - providers/ — Jira/GitHub API 客户端和本地 Git 操作 - tools/ — MCP 工具定义与实现 - resources/ — MCP 资源（工作流指南、issue 上下文） - prompts/ — server 内部用于引导 agent 行为的 AI prompt

• tests/ — 集成测试和单元测试

• pyproject.toml — 项目元数据和依赖

• uv.lock — 依赖锁定文件

Architecture Overview

系统设计和主要组件的高层概述。查看完整架构文档：docs/architecture.md

安装与设置

环境要求

• Python 3.10+

• Git (已添加到 PATH)

• 具有 REST API v3 访问权限的 Jira 实例 (Cloud 或私有部署)

• 具有基于 token 的 API 访问权限的 GitHub 仓库

1. 克隆仓库

bash

git clone https://github.com/YOUR-USERNAME/jira-github-mcp.git

cd jira-github-mcp

uv venv

python -m venv .venv

uv sync

pip install -r requirements.txt

# Jira Configuration
JIRA_BASE_URL=https://your-instance.atlassian.net
[email protected]
JIRA_API_TOKEN=your-jira-api-token

GitHub Configuration
GITHUB_TOKEN=your-github-personal-access-token
GIT_REPO_URL=https://github.com/owner/repo.git
GIT_DEFAULT_BRANCH=main
Optional: Local Git Repository Path
If omitted, defaults to the current working directory
GIT_REPO_LOCAL_PATH=/path/to/local/repo

python -m src.server.server

mcp-server

{
  "servers": {
    "jira-github-mcp-server": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "src.server.server"],
      "cwd": "/absolute/path/to/jira-github-mcp"
    }
  }
}