AI导哈

Jira集成服务器

一个提供与Jira无缝集成的模型上下文协议（MCP）服务器，使AI助手能够直接与Jira工单交互。

  • by DevPabloGarcia
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 DevPabloGarcia/JiraMcp

使用说明

Jira MCP 服务器

一个模型上下文协议（MCP）服务器，它能与Jira实现无缝集成，使像Claude这样的AI助手能够直接与您的Jira工单进行交互。

特点/特性

  • 获取问题详情获取特定Jira工单的完整信息
  • 搜索问题按项目、状态、负责人、问题类型、优先级等搜索工单
  • 获取我的问题快速获取分配给你的所有工单
  • 智能过滤通过简单参数构建复杂的JQL查询
  • 清洁输出自动从Atlassian文档格式（ADF）中提取并格式化数据

先决条件

  • Python 3.7或更高版本
  • 一个具有API访问权限的Jira帐户
  • Jira 个人访问令牌 (PAT)

安装

  1. 克隆此仓库：
git clone <repository-url>
cd JIRA_MCP_PY
  1. 创建并激活虚拟环境：
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. 安装依赖项：
pip install -r requirements.txt

配置

环境变量

JIRA_URL=https://your-instance.atlassian.net
JIRA_PAT=your_personal_access_token

获取您的Jira个人访问令牌

  1. 进入你的Jira设置
  2. 点击“开发者设置”
  3. 点击“创建API令牌”
  4. 给它起个令人难忘的名字

MCP 配置

将此服务器添加到您的MCP设置文件中（通常 ~/.config/claude/mcp.json)：

{
  "mcpServers": {
    "jira": {
      "command": "/path/to/JIRA_MCP_PY/venv/bin/python",
      "args": ["/path/to/JIRA_MCP_PY/jira_server.py"],
      "env": {
        "JIRA_URL": "https://your-instance.atlassian.net",
        "JIRA_PAT": "your_personal_access_token"
      }
    }
  }
}

使用方法

一旦配置完成，MCP服务器将提供三个主要工具：

1. 获取问题

检索特定Jira工单的详细信息：

Get details for issue KEY-123

2. 搜索问题

使用各种标准搜索票据：

Search for bugs in project PROJ that are in progress
Find all high priority tasks assigned to me

3. 获取我的问题

快速访问您分配的工单：

Show me my current tickets
What issues am I working on?

可用的搜索过滤器

  • 项目项目密钥（例如，“PROJ”，“DEV”）
  • 状态问题状态（例如，“待办”，“进行中”，“已完成”）
  • **被申请人（或受让人、权利受让人，具体含义需根据上下文确定）**电子邮件、姓名或“currentUser()”
  • 问题类型问题类型（例如，“错误”、“任务”、“故事”）
  • 优先权；首要事项优先级（例如，“P1”、“P2”、“P3”）
  • 修复版本目标版本（例如，“25.11”，“25.13”）
  • 文本在摘要和描述中搜索
  • 最大结果数限制结果数量（默认：20，最大：100）

发展

项目结构

JIRA_MCP_PY/
├── jira_server.py      # Main MCP server implementation
├── requirements.txt    # Python dependencies
├── .env.example       # Environment variables template
├── .gitignore         # Git ignore rules
└── README.md          # This file

运行测试

# Test the server locally
python jira_server.py

故障排除

认证错误

  • 验证您的 JIRA_URL 没有尾部斜杠
  • 确保您的个人培训账户（PAT）有效且未过期
  • 检查你是否在Jira中有适当的权限

连接问题

  • 确认您的Jira实例URL是否正确
  • 检查您的网络连接
  • 验证防火墙设置是否未阻止连接

做出贡献

欢迎贡献！请随时提交拉取请求。

许可证

MIT 许可证 - 欢迎自由地将此项目用于个人用途。

支持

对于问题和疑问：

  • 在GitHub上打开一个议题（或问题）
  • 检查Jira API文档：https://developer.atlassian.com/cloud/jira/platform/rest/v2/

致谢

使用……构建 模型上下文协议 由Anthropic开发。

相关 MCP