金大哥 - mcp-jira-python MCP 详情

article

README

🚀 MCP JIRA Python

MCP JIRA Python 是一个用于 JIRA 集成的 MCP 服务器的 Python 实现。MCP 是一种通信协议，旨在为您的 AI 提供工具，同时保障数据安全（如有需要，还能实现数据本地化）。该服务器可在与您的 AI 应用程序相同的计算机上运行，Claude Desktop 是首个运行 MCP 服务器的应用程序，同时它也是客户端。您可以查看 examples 文件夹中的简单 Python MCP 客户端示例。

🚀 快速开始

安装

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

✨ 主要特性

此 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 Desktop 配置

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

Windows

⚠️ 重要提示

在 Windows 中，claude_desktop_config.json 的路径为：

%AppData%\\Claude\\claude_desktop_config.json

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

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

    "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"
      }      
    }

⚠️ 重要提示

您必须关闭 Claude Desktop 并终止所有 Claude 进程，才能启用更新后的 claude_desktop_config.json！

Mac/Linux

将以下内容添加到 claude_desktop_config.json：

    "jira-api": {
      "command": "python3",
      "args": [
        "-m",
        "mcp_jira_python.server"
      ],
      "env": {
        "JIRA_HOST": "YOURNAME.atlassian.net",
        "JIRA_EMAIL": "yourname@example.com",
        "JIRA_API_TOKEN": "YOURJIRATOKEN"
      }      
    }

同样，您需要在终端中运行：

python3 -m mcp_jira_python.server

项目结构

MCP-JIRA-Python/
├── src/
│   └── jira_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_jira_api.py
    ├── test_jira_integration.py
    └── test_jira_mcp_system.py

mcp-jira-python