AI导哈

Jira集成服务器

用于Jira Server集成的MCP服务器，使AI助手能够通过标准化工具与Jira Server部署交互。

  • by bugzy-ai
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 bugzy-ai/jira-mcp-server

使用说明

@bugzy ai/jira mcp服务器

MCP（模型上下文协议）服务器用于Jira服务器（内部部署）集成。使像Claude这样的人工智能助手能够通过标准化工具与Jira Server部署进行交互。

特性

  • jira_search_问题 -使用JQL（Jira查询语言）搜索问题
  • jira_get_issue -获取特定问题的详细信息
  • jira_create_issue -在任何项目中创建新问题
  • jira_add_注释 -对现有问题添加评论

需求

  • Node.js 20.0.0或更高版本
  • Jira服务器/数据中心8.14+（用于PAT身份验证）或任何版本（用于基本身份验证）

安装

npm install @bugzy-ai/jira-mcp-server

或者直接使用npx运行：

npx @bugzy-ai/jira-mcp-server

配置

环境变量

变量 描述 必填
JIRA_BASE_URL 您的Jira服务器URL（例如。， https://jira.yourcompany.com) 是
JIRA_AUTH_TYPE 身份验证类型： pat 或 basic 否（默认值： pat)
JIRA_PAT 个人访问令牌（使用PAT身份验证时） 何时 JIRA_AUTH_TYPE=pat
JIRA_USERNAME 用户名（使用基本身份验证时） 何时 JIRA_AUTH_TYPE=basic
JIRA_PASSWORD 密码（使用基本身份验证时） 何时 JIRA_AUTH_TYPE=basic

创建个人访问令牌（PAT）

  1. 登录您的Jira服务器实例
  2. 点击您的个人资料图片> 个人资料
  3. 点击 个人访问令牌 在左侧边栏中
  4. 点击 创建令牌
  5. 为其命名，并可选择设置到期日期
  6. 复制生成的令牌

Claude桌面集成

将以下内容添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["@bugzy-ai/jira-mcp-server"],
      "env": {
        "JIRA_BASE_URL": "https://jira.yourcompany.com",
        "JIRA_AUTH_TYPE": "pat",
        "JIRA_PAT": "your-personal-access-token"
      }
    }
  }
}

或者，如果在本地安装：

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp-server/dist/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://jira.yourcompany.com",
        "JIRA_AUTH_TYPE": "pat",
        "JIRA_PAT": "your-personal-access-token"
      }
    }
  }
}

使用示例

配置后，您可以要求Claude：

  • “在TEST项目中搜索打开的错误”
  • “获取有关问题TEST-123的详细信息”
  • “在项目TEST中创建一个新错误，摘要为‘登录按钮不起作用’”
  • “在TEST-123中添加一条评论，说明该问题已被复制”

工具参考

jira_search_问题

使用JQL搜索问题。

参数：

  • jql （必填）：JQL查询字符串
  • maxResults （可选）：最大结果（1-100，默认值：50）
  • fields （可选）：要包含在响应中的字段

例子：

jql: "project = TEST AND status = Open ORDER BY created DESC"
maxResults: 20

jira_get_issue

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

参数：

  • issueKey （必填）：发布密钥（例如“TEST-123”）
  • fields （可选）：要检索的特定字段
  • expand （可选）：要扩展的其他数据（例如，“更改日志”、“转换”）

jira_create_issue

创建新问题。

参数：

  • projectKey （必填）：项目密钥（例如“TEST”）
  • summary （必填）：问题摘要/标题
  • issueType （必填）：问题类型（例如，“Bug”、“任务”、“故事”）
  • description （可选）：问题描述
  • priority （可选）：优先级名称（例如，“高”、“中”）
  • assignee （可选）：要分配的用户名
  • labels （可选）：标签数组
  • components （可选）：组件名称数组

jira_add_注释

为现有问题添加注释。

参数：

  • issueKey （必填）：发布密钥（例如“TEST-123”）
  • body （必填）：评论文本（支持Jira wiki标记）
  • visibility （可选）：可见性限制（组或角色）

发展

先决条件

  • Node.js 20+
  • Docker（用于本地Jira实例）
  • 6GB+RAM可用于Docker

快速开始

# Clone the repository
git clone https://github.com/bugzy-ai/jira-mcp-server.git
cd jira-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Setup local Jira (Docker)
npm run setup

本地Jira设置

安装脚本将：

  1. 启动Jira Docker容器
  2. 等待Jira准备就绪（首次启动时约3-5分钟）
  3. 指导您完成手动设置（许可证+管理员用户）
  4. 创建一个用于开发的TEST项目
  5. 生成一个 .env 具有本地凭据的文件

首次运行需要手动执行以下步骤：

  1. 打开http://localhost:8080在浏览器中
  2. 完成安装向导
  3. 拿一个 免费评估许可证 或 定时炸弹许可证
  4. 创建管理员用户（建议： admin/admin)
  5. 跑 npm run setup 再次创建测试项目

测试

使用MCP检查器（调试单个工具）：

npm run dev
# Opens browser at http://localhost:6274

使用Claude Code（对话中测试）：

  1. 该项目包括 .mcp.json 配置本地服务器
  2. 重新启动Claude Code以获取配置
  3. 尝试：“在TEST项目中搜索问题”

可用脚本

脚本 描述
npm run build 构建TypeScript以进行dist/
npm run build:watch 使用手表模式构建
npm run dev 运行MCP检查器
npm run setup 设置本地Jira Docker
npm start 运行MCP服务器
npm run clean 删除dist/

Docker命令

# View Jira logs
docker logs jira-mcp-test

# Stop Jira
docker stop jira-mcp-test

# Start Jira
docker start jira-mcp-test

# Remove container (loses data)
docker rm -f jira-mcp-test

许可证

麻省理工学院

相关 MCP