AI导哈

Jira MCP 服务器

连接Jira和Claude的Model Context Protocol (MCP)服务器，提供Jira问题搜索、创建、更新等功能。

  • by SunWooBang
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 SunWooBang/jira-mcp-server

使用说明

Jira MCP服务器

连接Jira和Claude的Model Context Protocol（MCP）服务器。

功能

  • 搜索问题：使用JQL搜索Jira问题
  • 查询问题：查看特定问题的详细信息
  • 创建问题：创建新的Jira问题
  • 更新问题：修改现有问题（标题、说明、状态、联系人）
  • 添加评论：向问题添加评论
  • 项目信息：查看项目信息

安装和设置

1.设置环境变量

.env 创建文件并输入以下信息：

JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your-email@domain.com
JIRA_API_TOKEN=your-api-token
DEFAULT_PROJECT_KEY=PROJ

请参见：配置文件 config/ 在文件夹中自动创建。

2.生成Jira API令牌

  1. 登录Jira
  2. 帐户设置>安全性>生成API令牌
  3. 生成的令牌 .env 文件的 JIRA_API_TOKEN在中输入

3.安装依赖性

npm install

4.自动设置（建议）

可以使用交互式设置工具轻松设置：

npm run setup

此命令为：

  • 接收Jira连接信息
  • config/.env 自动创建文件
  • config/claude_desktop_config.json 自动创建文件
  • 介绍如何设置Claude Desktop

5.手动设置（可选）

手动设置而不是自动设置的步骤 config/.env.example 复制文件 config/.env请重命名为并修改值。

6.运行服务器

npm start

Claude桌面设置

要在Claude Desktop中使用此MCP服务器，必须修改配置文件。

视窗

%APPDATA%\\Claude\\claude_desktop_config.json 编辑文件：

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["C:\\path\\to\\jira-mcp-server\\index.js"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@domain.com",
        "JIRA_API_TOKEN": "your-api-token",
        "DEFAULT_PROJECT_KEY": "PROJ"
      }
    }
  }
}

macOS

~/Library/Application Support/Claude/claude_desktop_config.json 编辑文件：

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp-server/index.js"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@domain.com", 
        "JIRA_API_TOKEN": "your-api-token",
        "DEFAULT_PROJECT_KEY": "PROJ"
      }
    }
  }
}

使用示例

在Claude中可以使用以下命令：

搜索问题

"프로젝트 PROJ에서 상태가 Open인 이슈들을 찾아줘"

创建问题

"PROJ 프로젝트에 '새로운 기능 개발' 제목으로 Task 이슈를 생성해줘"

更新问题

"PROJ-123 이슈의 상태를 'In Progress'로 변경해줘"

添加评论

"PROJ-123 이슈에 '작업을 시작했습니다' 댓글을 추가해줘"

支持的工具

  1. 搜索问题：使用JQL搜索问题
  2. 获取问题：查询特定问题
  3. 创建_发行：创建新问题
  4. update_issue：更新问题
  5. 添加注释：添加评论
  6. get_project_info：查看项目信息

故障排除

验证错误

  • 验证Jira URL是否正确
  • 验证API令牌是否有效
  • 验证用户电子邮件是否正确

权限错误

  • 验证用户是否有权访问该项目
  • 验证您是否具有创建/修改问题的权限

许可证

MIT许可证

相关 MCP