MCP-JIRA-Python Server

MCP JIRA Python 🚀

用于 JIRA 集成的 MCP 服务器的 Python 实现。MCP 是一种通信协议，旨在为您的 AI 提供工具并确保您的数据安全（如果您愿意，也可以将其本地化）。该服务器与您的 AI 应用程序在同一台计算机上运行，Claude Desktop 是第一个运行 MCP 服务器的应用程序（被视为客户端。请参阅示例文件夹中的简单 Python MCP 客户端）。

安装

可用工具

该 MCP 服务器提供以下 JIRA 集成工具：

• delete_issue ：使用问题键删除 Jira 问题或子任务
• create_jira_issue ：创建一个新的 Jira 问题，其中包含可自定义的字段，包括摘要、描述、类型、优先级和受让人
• get_issue ：检索完整的问题详细信息，包括给定问题键的评论和附件
• create_issue_link ：创建问题之间的关系（例如，“阻止”、“被阻止”等）
• update_issue ：使用摘要、描述、状态、优先级或受让人等字段的新值更新现有问题
• get_user ：使用电子邮件地址查找用户的帐户 ID
• list_fields ：获取所有可用 JIRA 字段及其属性的列表
• list_issue_types ：检索 JIRA 实例中所有可用的问题类型
• list_link_types ：获取问题链接的所有可能的关系类型
• search_issues ：使用 JQL（JIRA 查询语言）在特定项目中搜索问题
• add_comment ：向现有问题添加文本评论
• add_comment_with_attachment ：向问题添加带有附件的评论

Claude桌面配置

这需要您更新 claude_desktop_config.json。该文件的位置因 Apple、Windows 或 Linux 而异。

视窗

注意：claude_desktop_config.json 在 Windows 中的位置是：

这将（通常）解析为：C:\Users\YOURUSERNAME\AppData\Roaming\Claude

以下是要添加到 claude_desktop_config.json 的配置块。在 Windows 系统中，我们始终使用完整路径。您需要更新“command”，设置目录路径，并添加 JIRA 环境设置。

☠️警告 - 您必须关闭 Claude Desktop 并终止所有 Claude 进程才能启用更新的 claude_desktop_config.json！😬

Mac 和 Linux

将文件路径更新为 mcp-jira-python 并填写您的 JIRA 环境值：

笔记：

保存对 claude_desktop_config.json 的更改后，必须重新启动 Claude Desktop。

运行 MCP JIRA Python 工具

这些 MCP 工具列在 jira-api 服务器下。您可以点击 Claude Desktop 文本输入框右下角的小锤子图标查看列表。请确认 jira-api 工具在列表中可用。要“运行”某个工具，只需让 Claude 专门执行一个 Jira 任务即可。需要注意的是，Claude 一开始可能看不到这些工具，需要提醒他。在某些情况下，他会拒绝使用工具。建议更新系统提示。

运行测试

TODO - 添加运行测试的描述（unittest）TODO - 添加一些代码以使测试更容易获取环境变量，因为集成和系统测试需要以下环境变量：

TODO——生成测试覆盖率报告：

项目结构