local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides tools for comprehensive JIRA issue management including creating, updating, deleting, and searching issues, managing issue links and relationships, adding comments and attachments, retrieving user information, and accessing field and issue type metadata.

MCP JIRA Python 🚀

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

安装

# Install the server locally
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桌面配置

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

视窗

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

%AppData%\\Claude\\claude_desktop_config.json

这将（通常）解析为：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 - 添加一些代码以使测试更容易获取环境变量，因为集成和系统测试需要以下环境变量：

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

基于 Python 的服务器允许与 JIRA 无缝集成，以便通过自定义 API 管理和与项目交互。

Related Resources

Reddit Discussion about this server

MCP-JIRA-Python Server