JIRA服务协议工具

一个用于与JIRA Cloud交互的模型上下文协议(MCP)服务器,提供搜索问题、添加评论、管理转换等功能。

  • by yuuues
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 yuuues/mcp-jira

使用说明

MCP JIRA服务器

用于与JIRA Cloud交互的模型上下文协议(MCP)服务器。此服务器提供搜索问题、添加评论、管理转换等工具。

安装

pip install -r requirements.txt

配置

JIRA API代币

  1. 首选https://id.atlassian.com/manage/api-tokens
  2. 创建新的API令牌
  3. 使用您的Atlassian电子邮件和令牌进行身份验证

环境变量

您可以使用环境变量配置服务器:

export MCP_JIRA_SERVER=your-domain.atlassian.net
export MCP_JIRA_EMAIL=user@example.com
export MCP_JIRA_TOKEN=your-api-token
export MCP_PORT=35002

或复制 .env.example 到 .env 并填写你的价值观。

用法

命令行

python mcp_server.py --server your-domain.atlassian.net --email user@example.com --token YOUR_API_TOKEN --port 35002

客户端配置(mcp.json)

{
  "mcpServers": {
    "mcp-jira": {
      "url": "http://localhost:35002/mcp",
      "headers": {
        "X-MCP-JIRA-SERVER": "your-domain.atlassian.net",
        "X-MCP-JIRA-EMAIL": "user@example.com",
        "X-MCP-JIRA-TOKEN": "your-api-token"
      }
    }
  }
}

可用工具

工具 说明
get_issue 获取单个问题的详细信息
search_issues 使用JQL搜索问题
add_comment 向问题添加评论
get_transitions 获取问题的可用转换
transition_issue 更改问题的状态
get_projects 列出所有可访问的项目
assign_issue 将问题分配给用户
get_myself 获取已验证用户的信息

认证

服务器支持具有以下优先级的多个凭据源:

  1. 功能参数(最高优先级)
  2. HTTP标头(X-MCP-JIRA-*)
  3. 环境变量(最低优先级)

HTTP头处理模块

  • X-MCP-JIRA-SERVERJIRA服务器URL(例如。, your-domain.atlassian.net)
  • X-MCP-JIRA-EMAIL:Atlassian帐户电子邮件
  • X-MCP-JIRA-TOKEN:API令牌

📄 许可证

是啊

麻省理工学院


最新更新: 2026年3月