
MCP JIRA Python 🚀

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
: 通过电子邮件查找用户账户IDlist_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
调试方式
- 更新claude_desktop_config.json文件
- 设置正确的文件路径和JIRA环境变量
- 重启Claude Desktop
- 检查工具是否出现在工具列表中
运行测试
需要设置以下环境变量:
export JIRA_HOST="your-domain.atlassian.net"
export JIRA_EMAIL="[email protected]"
export JIRA_API_TOKEN="your-api-token"