MCP JIRA Python 🚀

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

安装

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

可用工具

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

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

Claude Desktop 配置

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

Windows

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

%AppData%\\Claude\\claude_desktop_config.json

这通常会解析为： C:\Users\YOURUSERNAME\AppData\Roaming\Claude

以下是要添加到 claude_desktop_config.json 的配置块。 对于 Windows，我们始终使用完整路径。 您将更新“command”，设置您的目录路径，并添加您的 JIRA env 设置 <pre> "jira-api": { "command": "C:\\Users\\YOURUSERNAME\\.local\\bin\\uv.exe", "args": [ "--directory", "D:\\mcp\\mcp-jira-python", "run", "-m", "mcp_jira_python.server" ], "env": { "JIRA_HOST": "YOURNAME.atlassian.net", "JIRA_EMAIL": "yourname@example.com", "JIRA_API_TOKEN": "YOURJIRATOKEN" }
} </pre>

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

Mac 和 Linux

更新 mcp-jira-python 的文件路径并填写您的 JIRA env 值： <pre> "mcp-jira-python": { "command": "uv", "args": [ "run", "--directory", "/your/filepath/mcp-jira-python", "src/jira-api/server.py" ], "env": { "JIRA_HOST": "your_org.atlassian.net", "JIRA_EMAIL": "you@your_org.com", "JIRA_API_TOKEN": "your_api_token" }
} </pre>

注意：

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

运行 MCP JIRA Python 工具

这些 MCP 工具列在 jira-api 服务器下。 您可以通过单击 Claude Desktop 文本输入框右下角的小锤子来查看列表。 请验证 jira-api 工具是否在列表中可用。 要“运行”一个工具，只需明确要求 Claude 执行 Jira 任务。 值得注意的是，Claude 可能一开始看不到这些工具，需要进行提示。 在某些情况下，他会拒绝使用工具。 建议更新系统提示。

运行测试

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

export JIRA_HOST="your-domain.atlassian.net"
export JIRA_EMAIL="your-email@example.com"
export JIRA_API_TOKEN="your-api-token"

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

项目结构

mcp-jira-python/
├── README.md
├── pyproject.toml
├── src/
│   └── jira_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_jira_api.py
    ├── test_jira_integration.py
    └── test_jira_mcp_system.py