Skip to main content
Glama
mcp-jira-server

mcp-jira-server

by 1broseidon

Jira MCP 服务器

模型上下文协议服务器提供与 Jira 的 REST API 的集成,允许 AI 助手以编程方式管理 Jira 问题。

特征

该服务器提供管理 Jira 问题的工具:

  • 创建新问题(任务、史诗、子任务)

  • 列出具有可选状态过滤的问题

  • 更新现有问题(摘要、描述、状态)

  • 获取详细的问题信息

  • 删除问题

  • 对问题添加评论

Related MCP server: JIRA MCP Server

设置

先决条件

  1. 具有 API 访问权限的 Jira 帐户

  2. Jira API 令牌(可从Atlassian 帐户设置生成)

安装

  1. 安装依赖项:

npm install
  1. 构建服务器:

npm run build

配置

  1. 在您的工作目录中创建一个.jira-config.json文件:

{
  "projectKey": "YOUR_PROJECT_KEY"
}
  1. 使用您的 Jira 凭据配置 MCP 服务器:

在 MacOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-server/build/index.js"],
      "env": {
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

可用工具

创建问题

创建新的 Jira 问题

  • 必需参数:

    • working_dir:包含 .jira-config.json 的目录

    • 摘要:问题标题

    • 描述:问题描述

    • 类型:问题类型(任务、史诗或子任务)

列出问题

列出项目中的问题

  • 必需参数:

    • working_dir:包含 .jira-config.json 的目录

  • 可选参数:

    • 状态:按状态过滤(例如“待办”、“进行中”、“完成”)

更新问题

更新现有问题

  • 必需参数:

    • working_dir:包含 .jira-config.json 的目录

    • issue_key:发行密钥(例如 PRJ-123)

  • 可选参数:

    • 摘要:新标题

    • 描述:新描述

    • 状态:新状态

获取问题

获取有关特定问题的详细信息

  • 必需参数:

    • working_dir:包含 .jira-config.json 的目录

    • issue_key:发行密钥(例如 PRJ-123)

删除问题

删除 Jira 问题

  • 必需参数:

    • working_dir:包含 .jira-config.json 的目录

    • issue_key:发行密钥(例如 PRJ-123)

添加评论

向现有问题添加评论

  • 必需参数:

    • working_dir:包含 .jira-config.json 的目录

    • issue_key:发行密钥(例如 PRJ-123)

    • 评论:要添加的评论文本

发展

对于使用自动重建的开发:

npm run watch

错误处理

该服务器包括针对以下方面的全面错误处理:

  • 项目密钥无效

  • 缺少配置

  • 无效的问题类型

  • API 身份验证错误

  • 无效状态转换

输出格式

问题信息的格式包括:

  • 问题关键和摘要

  • 问题类型和状态

  • 创建日期和创建者

  • 描述

  • 带有作者和时间戳的评论(如果有)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides tools for AI assistants to interact with JIRA APIs, enabling them to read, create, update, and manage JIRA issues through standardized MCP tools.
      6
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Jira Cloud and Server/Data Center deployments for issue management, project tracking, and workflow automation. Supports multiple authentication methods including API tokens, OAuth 2.0, and personal access tokens.
      MIT