Jira项目管理服务器

Jira MCP服务器

A. 模型上下文协议（MCP） 连接的服务器 克劳德桌面版 （或任何兼容MCP的AI客户端） 吉拉云，通过自然语言实现全面的项目管理——创建问题、管理冲刺、记录时间、链接问题、更新评论等。

31工具 涵盖完整的Jira工作流程：问题创建和编辑、冲刺生命周期、评论管理、工作日志跟踪、问题链接和团队/项目发现。

目录

• 先决条件
• 设置
• 连接到克劳德桌面
• 环境变量
• 可用工具
• 示例提示
• 项目结构
• Jira安装说明
• 故障排除

先决条件

验证安装：

python --version   # Should print 3.10 or higher
git --version

设置

1.克隆存储库

git clone https://github.com/myridius-siddarthaaggarwal/Jira-MCP-server.git
cd Jira-MCP-server

2.创建虚拟环境

python -m venv venv

激活它：

3.安装依赖项

pip install -r requirements.txt

连接到克劳德桌面

服务器由Claude Desktop自动启动，您不需要手动启动。

步骤1--找到Claude Desktop配置文件

如果文件不存在，则创建该文件。

步骤2——注册服务器

将以下内容粘贴到配置文件中，替换占位符值：

窗户：

{
  "mcpServers": {
    "jira-mcp-server": {
      "command": "C:\\Users\\<YourUsername>\\Jira-MCP-server\\start_mcp.bat",
      "env": {
        "JIRA_BASE_URL": "https://yourorg.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Mac/Linux：

{
  "mcpServers": {
    "jira-mcp-server": {
      "command": "/bin/bash",
      "args": ["-c", "cd /path/to/Jira-MCP-server && source venv/bin/activate && python main.py"],
      "env": {
        "JIRA_BASE_URL": "https://yourorg.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

替换 <YourUsername> 以及符合您实际值的路径。

步骤3-获取Jira API代币

1. 首选https://id.atlassian.com/manage-profile/security/api-tokens
2. 点击 创建API令牌
3. 给它起个名字（例如。， claude-mcp)并复制令牌
4. 将其粘贴为值 JIRA_API_TOKEN 在上面的配置中

步骤4--重新启动克劳德桌面

关闭并重新打开Claude Desktop。Jira工具将可用——寻找 🔨 工具图标 在聊天输入区域中。

环境变量

必需

可选--自定义字段ID

Jira使用的自定义字段ID可能因实例而异。以下默认设置适用于大多数Jira Cloud设置。仅当您的实例使用不同的字段ID时才覆盖它们（通过Jira的字段配置或浏览器开发工具检查）。

下一代/团队管理的项目： 集 JIRA_EPIC_LINK_FIELD_ID=parent 使用父关系而不是经典的史诗链接字段将问题与史诗联系起来。

可用工具

问题创建

所有创建工具都接受这些参数：

问题阅读和搜索

search_issues JQL示例：

project = PROJ AND status = "In Progress"
assignee = currentUser() AND sprint in openSprints()
project = PROJ AND issuetype = Bug AND priority = High
text ~ "login crash" ORDER BY created DESC

问题编辑

update_issue 可编辑字段：

状态转换

提示： 使用 update_issue 随着 status_name 按名称转换——不需要先查找ID。

评论管理

工作日志/时间跟踪

add_worklog 时间格式： 2h, 1d, 30m, 1d 4h 30m

Sprint管理

Sprint工作流程：

1. get_boards → 查找您的董事会ID
2. create_sprint → 创建未来冲刺
3. add_issues_to_sprint → 填充它
4. update_sprint 随着 state="active" → 开始吧
5. update_sprint 随着 state="closed" → 完成它

问题链接

发现和元数据

示例提示

连接到Claude Desktop后，您可以使用自然语言：

产生问题：

• “在PROJ项目中为登录页面崩溃创建一个高优先级错误，将其分配给john@example.com，将其添加到当前冲刺中，并给它3个故事点”
• “在PROJ中创建一个名为“重新设计结账流程”的故事，有8个故事点，将其链接到史诗般的PROJ-10”
• “从4月14日开始，到4月28日结束，在42号机上创建Sprint 5，目标是‘Ship payments v2’”

查看和搜索：

• “获取PROJ-123的详细信息”
• “显示PROJ项目中分配给我的所有进行中的错误”
• “在PROJ中搜索有关付款失败的票证”
• “列出42号板的所有冲刺”

编辑：

• “将PROJ-123移至完成”
• “将PROJ-456的优先级更改为高，并将其分配给Sarah”
• “将PROJ-789上的故事点更新为5”
• “将PROJ-100和PROJ-101添加到冲刺55”
• “将PROJ-200移回待办事项列表”

评论和时间：

• “在PROJ-123中添加一条评论，说明该修复程序已部署到登台”
• “显示PROJ-456上的所有评论”
• “编辑PROJ-123上的注释12345，改为‘v2.1中已修复’”
• “在PROJ-789上记录2小时的工作”

链接和发现：

• “将PROJ-1链接为阻止PROJ-2”
• “查找的帐户IDjohn@example.com"
• “PROJ项目中有哪些可用的问题类型？”
• “列出Jira中的所有优先级”

项目结构

Jira-MCP-Server/
├── main.py                # MCP server entry point — initialises FastMCP and registers tools
├── start_mcp.bat          # Windows launcher used by Claude Desktop
├── requirements.txt       # Python dependencies (mcp[cli], requests)
├── .gitignore             # Excludes venv, credentials, cache files
├── test_jira.py           # Manual integration test script
│
├── api/
│   └── jira_client.py     # All Jira REST API calls (api/3 and agile/1.0)
│
├── config/
│   └── settings.py        # Reads credentials and field IDs from environment variables
│
└── tools/
    └── jira_tools.py      # 31 MCP tool definitions registered with FastMCP

运作原理

Claude Desktop
     │
     │  MCP protocol (stdio)
     ▼
  main.py  ──registers──▶  tools/jira_tools.py  ──calls──▶  api/jira_client.py
                                                                     │
                                                              HTTP (requests)
                                                                     │
                                                              Jira Cloud REST API

Jira安装说明

查找您的董事会ID

1. 转到您的Jira项目→ 待办事项列表或董事会视图
2. 请查看URL： .../jira/software/projects/PROJ/boards/42 — 42 是板ID
3. 或者使用 get_boards 带有项目密钥的工具

查找自定义字段ID

如果默认自定义字段ID不适用于您的实例：

1. 在Jira，前往 设置→ 问题→ 自定义字段
2. 点击该字段并记下URL中的ID(customfield_XXXXX)
3. 设置适当的 JIRA_*_FIELD_ID 环境变量

经典项目与下一代项目

Atlassian帐户ID

帐户ID（用于受让人）看起来像 5b10ac8d82e34311xxxxxxxxxxx。用 search_users 工具或Jira的用户配置文件URL中。

故障排除

依赖项

mcp[cli]>=1.1.0    # Model Context Protocol framework
requests>=2.31.0   # HTTP client for Jira REST API calls

安装方式： pip install -r requirements.txt

贡献

1. 分叉存储库
2. 创建要素分支： git checkout -b feature/my-new-tool
3. 在中进行更改 api/jira_client.py （API逻辑）和 tools/jira_tools.py （工具定义）
4. 使用以下命令对真实的Jira实例进行测试 test_jira.py
5. 打开拉取请求

许可证

MIT——免费使用、修改和分发。