Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (git-jira-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Jira MCP Server

这是一个用于获取 Jira 需求信息的 MCP 服务器，基于当前 Git 分支名自动获取对应的 Jira 需求详情。

功能特性

自动分支识别：自动从当前 Git 分支名中提取 Jira ID
需求信息获取：获取 Jira 需求的详细信息，包括：
- 需求标题
- 需求描述
- 需求状态
- 优先级
- 负责人
错误处理：提供清晰的错误信息，包括：
- 分支名格式错误
- API 请求失败
- 环境变量缺失

安装

克隆仓库：

git clone https://github.com/1pone/git-jira-mcp-server.git
cd git-jira-mcp-server

安装依赖：

npm install

配置环境变量：创建 .env 文件并添加以下配置：

JIRA_INSTANCE_URL=https://your-domain.atlassian.net
JIRA_USER_EMAIL=your.email@example.com
JIRA_API_KEY=your_api_token
JIRA_BRANCH_PATTERNS=dev_[a-zA-Z]+-([A-Z]+-\d+),feature/[a-zA-Z]+-([A-Z]+-\d+),bugfix/[a-zA-Z]+-([A-Z]+-\d+),dev_[a-zA-Z]+_([A-Z]+-\d+)

使用方法

构建项目

npm run build

运行服务

npm start

开发模式（自动重新编译）

npm run watch

在 Cursor IDE 中使用

{
  "jira": {
      "command": "node",
      "type": "stdio",
      "args": ["path/to/dist/index.js"],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-domain.atlassian.net",
        "JIRA_USER_EMAIL": "your.email@example.com",
        "JIRA_API_KEY": "your_api_token",
        "JIRA_BRANCH_PATTERNS": "dev_[a-zA-Z]+-([A-Z]+-\\d+),feature/[a-zA-Z]+-([A-Z]+-\\d+),bugfix/[a-zA-Z]+-([A-Z]+-\\d+),dev_[a-zA-Z]+_([A-Z]+-\\d+)"
      }
    } 
}

分支命名规范

支持以下分支命名格式：

dev_[name]-[JIRA-ID]
feature/[name]-[JIRA-ID]
bugfix/[name]-[JIRA-ID]

例如：

dev_feature-ABC-123
feature/new-ui-ABC-123
bugfix/login-ABC-123

许可证

MIT License