Vibe Coded Jira MCP

JIRA MCP 服务器

一个简单的 模型上下文协议（MCP） “氛围编码”（vibe-coded）服务器，用于将JIRA与AI编码助手集成。MCP是一种开放协议，它实现了大型语言模型（LLM）应用与外部数据源和工具之间的无缝集成。

最初为Cursor集成开发环境（IDE）设计的这个服务器，现在支持包括Claude Code和Codex CLI在内的多个AI编码助手。

当心！就连这份文件也几乎完全是由AI编码助手撰写的。

特点

• 通过密钥获取JIRA问题
• 使用JQL（JIRA查询语言）搜索问题
• 创建和更新问题（注：在高度定制的JIRA项目中可能存在限制）
• 在问题上添加评论
• 克隆问题（有助于绕过强制自定义字段的限制，但在复杂项目配置中可能有限制）
• 可配置字段选择
• 分页支持
• 详细的错误处理和日志记录
• 记录工作日志

用户工作流

搜索和过滤流程

graph LR
    A[Start Search] -->|Enter JQL| B[Search Query]
    B -->|Apply Filters| C[Results]
    C -->|Select Fields| D[Customized View]
    D -->|Pagination| E[More Results]
    
    subgraph Search Options
        F[JQL Query]
        G[Field Selection]
        H[Result Limit]
        I[Start Position]
    end
    
    B -->|Uses| F
    C -->|Uses| G
    C -->|Uses| H
    C -->|Uses| I

问题克隆流程

graph LR
    A[Find Source Issue] -->|Copy Key| B[Clone Issue]
    B -->|Customize Fields| C[Modified Clone]
    C -->|Create| D[New Issue]
    
    subgraph Clone Options
        E[Change Project]
        F[Modify Fields]
        G[Copy Attachments]
        H[Add Source Link]
    end
    
    B -->|Can Use| E
    B -->|Can Use| F
    B -->|Can Use| G
    B -->|Can Use| H

要了解详细的技术架构和系统工作流程，包括问题生命周期和认证流程，请参阅 ARCHITECTURE.md（文件名可译为“架构.md”，但通常文件名保持原样不翻译，所以直接为“ARCHITECTURE.md”）。

关于MCP

这台服务器实现了 模型上下文协议 该规范使得AI编码助手能够与JIRA数据实现无缝交互。该协议标准化了大型语言模型（LLM）应用程序与外部数据源和工具之间的通信方式。

🚀 快速集成

用于AI助手集成见 AI_INTEGRATION.md（文件名可译为“人工智能集成说明.md”或保持原样，根据上下文决定是否需要翻译文件名） 以下是完整的设置指南：

• 🤖 表示机器人。 克劳德·科德 - 现代MCP集成
• 🎯（目标/瞄准） Cursor 集成开发环境（IDE） - 原始集成（多种设置选项）
• 🧠 表示“大脑”或“思考”的意思。 Codex CLI（可译为“Codex 命令行界面”或根据具体上下文简化为“Codex CLI工具”） - 请参阅Codex CLI部分 AI_INTEGRATION.md 翻译为中文是：“AI集成.md”（注：.md通常表示Markdown文件格式，但在中文语境下，我们通常直接保留文件扩展名，不翻译其含义）。不过，如果需要更自然的表达，可以翻译为“AI集成说明文档.md”或“AI集成指南.md”，具体取决于文件的实际内容和用途

设置

1. 创建一个虚拟环境：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

1. 安装依赖项：

pip install -r requirements.txt

1. 配置环境变量：

创建一个 .env 与以下文件一起：

JIRA_URL=your_jira_url
JIRA_USERNAME=your_username
JIRA_API_TOKEN=your_api_token

使用方法

运行服务器：

./run-jira-mcp.sh

发展

该项目采用模块化结构：

src/
├── core/           # Core JIRA client implementation
│   ├── __init__.py
│   ├── client.py   # JiraClient class
│   └── config.py   # Configuration management
├── models/         # Pydantic models for validation
│   ├── __init__.py
│   ├── comment.py  # Comment-related models
│   ├── issue.py    # Issue-related models
│   └── worklog.py  # Worklog-related models
└── operations/     # MCP operation implementations
    ├── __init__.py
    ├── comments.py # Comment operations
    ├── issues.py   # Issue operations
    ├── projects.py # Project operations
    └── worklog.py  # Worklog operations

关键组件

1. 模型 (src/models/)

- IssueType， IssueArgs - 问题创建/更新模型 - IssueTransitionArgs - 问题状态转移模型 - CloneIssueArgs - 问题克隆模型 - CommentArgs， GetCommentsArgs - 注释模型 - LogWorkArgs - 工作日志模型

1. 核心 (src/core/）

- JiraClient 主JIRA API客户端 - JiraConfig - 配置管理 - 错误处理和日志记录

1. 操作 (src/operations/)

- 问题管理（获取、搜索、创建、更新、克隆） - 评论处理（添加，获取） - 工作日志记录 - 项目列表

该项目遵循概述在（某处/某文件中）的实施计划 IMPLEMENTATION_PLAN.md。

当前版本：v0.4

• ✅ 基本的JIRA集成
• ✅ 支持JQL的搜索功能
• ✅ 问题管理（创建、更新、克隆），针对高度定制化项目设有限制
• ✅ 评论功能
• ✅ 工作日志记录

相关链接

• 模型上下文协议 - 主要的MCP项目
• MCP Python SDK - 我们用来实现这个服务器的SDK
• MCP 文档 - 协议文档和规范

许可证

麻省理工学院（MIT）

安全考虑因素

此工具主要设计用于个人工作流程自动化及个人开发者使用。请注意以下安全事项：

⚠️ 使用建议

• 个人/开发用途非常适合管理其JIRA工作流程的独立开发者
• 小团队使用适用于有适当安全措施的可信赖团队环境
• 不建议用于：

- 以当前形式进行生产部署 - 多租户环境 - 面向公众的服务 - 处理敏感/受监管数据

🔒 安全要求

如果您选择使用此工具，请确保：

1. 您的JIRA实例使用HTTPS
2. 您正在使用API令牌（而非密码）进行身份验证
3. 你的 .env 文件已妥善保存且未提交到版本控制系统
4. 您了解运行具有JIRA访问权限的第三方工具所存在的风险

🛡️ 最佳实践

1. 定期轮换您的API令牌
2. 监控您的JIRA审计日志，以发现异常活动
3. 使用该工具的最新版本
4. 在将代码用于您的环境之前，请进行审查

📝 关于企业使用的说明

此工具目前尚未针对企业安全需求进行加固。如果您需要企业部署的解决方案，请考虑：

• 实施额外的安全控制措施
• 进行安全审查
• 将安全改进贡献给项目
• 使用官方的企业级替代方案

如有关于安全的问题或要报告漏洞，请提交一个议题或直接联系维护者。