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 AND终止所有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