MCP JIRA Python 🚀

MCP JIRA Python 🚀

site icon
2025.01.22 3
PythonJIRA集成项目管理工具交流协作
MCP JIRA Python 是一个基于Python实现的MCP服务器,用于与JIRA进行集成。MCP是一种通信协议,旨在为AI提供工具并确保数据安全(可选择本地运行)。该服务器运行在与AI应用程序相同的计算机上,Claude Desktop是首个运行MCP服务器的应用程序(被视为客户端)。
View on GitHub

Overview

基本能力

产品定位

MCP JIRA Python 是一个用于JIRA集成的MCP服务器,提供了一系列工具来管理和操作JIRA中的问题(issues)。

核心功能

  • 删除JIRA问题或子任务
  • 创建新的JIRA问题,可自定义字段如摘要、描述、类型、优先级和分配人
  • 检索问题的完整详细信息,包括评论和附件
  • 创建问题之间的关系(如"blocks"、"is blocked by"等)
  • 更新现有问题的字段值
  • 通过电子邮件查找用户账户ID
  • 获取所有可用的JIRA字段及其属性
  • 检索JIRA实例中所有可用的问题类型
  • 获取所有可能的问题链接关系类型
  • 使用JQL(JIRA查询语言)在特定项目中搜索问题
  • 向现有问题添加文本评论
  • 向问题添加带有附件的评论

适用场景

  • 自动化JIRA问题管理
  • 集成JIRA到AI工作流中
  • 批量操作JIRA问题
  • 开发与JIRA集成的应用程序

工具列表

  • delete_issue: 根据问题键删除JIRA问题或子任务
  • create_jira_issue: 创建新的JIRA问题
  • get_issue: 检索问题的完整详细信息
  • create_issue_link: 创建问题之间的关系
  • update_issue: 更新现有问题
  • get_user: 通过电子邮件查找用户账户ID
  • list_fields: 获取所有可用的JIRA字段
  • list_issue_types: 检索所有可用的问题类型
  • list_link_types: 获取所有可能的问题链接关系类型
  • search_issues: 使用JQL搜索问题
  • add_comment: 向问题添加文本评论
  • add_comment_with_attachment: 向问题添加带有附件的评论

常见问题解答

  • 安装后需要更新claude_desktop_config.json文件
  • 在Windows上,配置文件位于%AppData%\Claude\claude_desktop_config.json
  • 修改配置后必须关闭Claude Desktop并终止所有Claude进程
  • 在Mac和Linux上也需要更新相应的文件路径和JIRA环境变量
  • 工具可能不会立即显示,需要重启Claude Desktop

使用教程

使用依赖

需要安装Python和git。

安装教程

# 本地安装服务器
git clone https://github.com/kallows/mcp-jira-python.git

调试方式

  1. 更新claude_desktop_config.json文件
  2. 设置正确的文件路径和JIRA环境变量
  3. 重启Claude Desktop
  4. 检查工具是否出现在工具列表中

运行测试

需要设置以下环境变量:

export JIRA_HOST="your-domain.atlassian.net"
export JIRA_EMAIL="[email protected]"
export JIRA_API_TOKEN="your-api-token"

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。