Jira MCP Server

Jira MCP 服务

此项目是一个充当 Jira 与 MCP（Model Context Protocol）之间桥梁的服务。它支持通过 MCP 接口同步和交互 Jira 数据。

使用的技术

• Kotlin：主要编程语言
• Ktor：用于创建 REST API 的 Web 框架
• Gradle：构建系统
• Docker：应用容器化
• MCP（Model Context Protocol）：用于互操作的通信协议

Docker 镜像

此项目提供两个 Docker 镜像，并将其构建并推送到 GitHub Container Registry：

• jira-mcp-stdio：配置为使用 stdio 模式通信的镜像。
• jira-mcp-sse：配置为使用 SSE（Server-Sent Events）模式通信的镜像。

注意：这些镜像会在主分支更新时自动构建并推送。

你可以使用以下命令从 GitHub Container Registry 拉取这些镜像：

docker pull ghcr.io/noxfr/jira-mcp-stdio:latest
docker pull ghcr.io/noxfr/jira-mcp-sse:latest

开发环境要求

• Java 21 或更高版本
• Docker 和 Docker Compose
• 拥有适当权限的 Jira 账户

配置

此项目需要以下环境变量：

• JIRA_URL：Jira 实例的 URL
• JIRA_EMAIL：与你的 Jira 账户关联的电子邮件地址
• JIRA_API_TOKEN：Jira API 令牌

2 种 MCP 模式：SSE 或 stdio

通过 Docker Compose 在本地运行

以下是 docker-compose.yml 的示例配置：

services:
  jira-mcp-server:
    image: ghcr.io/noxfr/jira-mcp-sse:latest
    ports:
      - "3001:3001"
    environment:
      - JIRA_URL=https://your-instance.atlassian.net
      - [email protected]
      - JIRA_PAT=your_jira_api_token

构建和运行

拉取并运行预构建的 Docker 镜像：

# Pull the Docker image
docker pull ghcr.io/noxfr/jira-mcp-sse:latest

# Run the service with Docker Compose
docker-compose up

或者，如果你更希望在本地构建镜像：

# Build the Docker image
docker-compose build

# Start the service
docker-compose up

服务将在端口 3001 上提供访问。

添加 MCP

在 IDE 中配置

HTTP（使用 jira-mcp-sse 镜像）

{
  "mcpServers": {
    "mcp-kotlin-jira-server": {
      "url": "http://127.0.0.1:3001/sse"
    }
  }
}

Stdio（使用 jira-mcp-stdio 镜像）

{
  "mcpServers": {
    "mcp-kotlin-jira-stdio": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "JIRA_URL",
        "-e",
        "JIRA_EMAIL",
        "-e",
        "JIRA_PAT",
        "ghcr.io/noxfr/jira-mcp-stdio:latest"
      ],
      "env": {
        "JIRA_URL": "TBD",
        "JIRA_EMAIL": "TBD",
        "JIRA_PAT": "TBD"
      }
    }
  }
}

AI 助手使用示例

以下是通过 AI 助手（例如 Claude Desktop 或 Cursor）与 MCP 交互的示例：

• 修复项目 XXX 中所有涉及标签错误的问题，并将其状态设为待审核
• 为问题 XXX 提出实现方案 等等。

可用工具

此服务通过 MCP 提供以下工具：

• search_issues：使用 JQL 搜索 JIRA 问题。
• get_issue：获取特定 JIRA 问题的详细信息，包括评论。
• update_issue：更新现有 JIRA 问题。
• get_transitions：获取 JIRA 问题可用的状态转换。
• transition_issue：通过执行状态转换来更改 JIRA 问题的状态。
• get_users：搜索 JIRA 用户。
• assign_issue：将 JIRA 问题分配给用户。