JIRA MCP Server 🚀
2025.04.17
0
GoJIRA 集成MCP 协议自动化工具交流协作
JIRA MCP Server 是一个基于 Go 语言开发的服务器，实现了模型上下文协议（MCP），用于与 JIRA Cloud REST API 进行交互。它充当了支持 MCP 的系统（如 AI 助手或开发工具）与 JIRA Cloud API 之间的桥梁，允许用户通过标准化的 MCP 接口以编程方式执行常见的 JIRA 操作（如创建问题、搜索、检索详细信息等），从而避免了直接调用 JIRA API 的复杂性。
View on GitHub
Overview
基本能力
产品定位
JIRA MCP Server 是一个中间件，旨在通过 MCP 协议将 JIRA Cloud API 的功能暴露给支持 MCP 的系统，如 AI 助手或开发工具。
核心功能
- MCP 接口：通过标准 MCP 端点暴露 JIRA 操作。
- JIRA Cloud 集成：支持创建问题、使用 JQL 搜索、检索问题详情以及获取 Epic 中的问题。
- 灵活的配置：使用 Viper 支持通过环境变量、配置文件或默认值进行配置。
- Docker 支持：支持通过 Docker 和 Docker Compose 进行容器化部署。
- 健壮的测试：包含全面的单元测试和集成测试。
- 结构化日志：使用
slog进行清晰的结构化日志记录。 - 依赖注入：基于
wire的依赖注入，遵循清洁架构原则。
适用场景
- 开发团队希望通过 AI 助手或自动化工具管理 JIRA 问题。
- 需要将 JIRA 功能集成到支持 MCP 的系统中。
- 希望通过编程方式批量操作 JIRA 问题。
工具列表
- Docker：用于容器化部署。
- Viper：用于灵活的配置管理。
- Wire：用于依赖注入。
- Slog：用于结构化日志记录。
常见问题解答
- 如何获取 JIRA API Token：需要在 JIRA Cloud 实例中生成 API Token，并与用户邮箱关联。
- 如何配置 Epic Link Field ID：可以通过 JIRA API 或管理设置找到该字段的 ID。
- 如何保护敏感信息：建议使用环境变量或安全的密钥管理系统，避免将敏感信息提交到版本控制中。
使用教程
使用依赖
- Go 1.20+：用于本地构建和运行。
- Docker & Docker Compose：用于容器化部署（可选）。
- JIRA Cloud 实例：需要访问 JIRA Cloud API。
- JIRA API Token：与用户邮箱关联的 API Token。
安装教程
- 克隆仓库：
bash git clone https://github.com/karolswdev/jira-mcp-server.git cd jira-mcp-server - 配置服务器：设置环境变量或创建
config.yaml文件。 - 运行服务器：
- 直接运行：
bash make run - 使用 Docker：
bash make docker-build make docker-run
调试方式
- 运行单元测试：
bash make test - 运行集成测试：
bash make test-integration - 查看测试覆盖率：
bash make coverage make coverage-integration