星战科技xingzhan.cloud
返回市场
杰拉命令行管理控制台

杰拉命令行管理控制台

作者：choplin5 星标更新：2025-06-09
安装使用来源：spider==github.com

项目介绍

Jira CLI MCP Server

CI License: MIT MCP

MCP（模型上下文协议）服务器封装了jira-cli命令行工具，使AI助手能够与Jira进行交互。

为什么选择jira-cli-mcp？

如果你正在寻找一个Jira MCP服务器，以下是jira-cli-mcp的独特之处：

  • 🚀 利用现有工具 - 无缝集成到现有的jira-cli设置和认证中
  • 🔒 安全第一 - 配置文件中不包含API令牌；认证由jira-cli处理
  • 🪶 轻量级 - 只需一个Bun进程，无需Docker或容器

在什么情况下使用mcp-atlassian？

如果你需要以下功能，请选择mcp-atlassian：

  • 需要Confluence支持（我们仅支持Jira）
  • 偏好Docker部署
  • 想要一个自包含解决方案，没有CLI依赖
  • 需要直接API集成而不是CLI封装

功能

  • 创建工单 - 使用可定制字段创建新的Jira工单
  • 列出工单 - 使用JQL查询搜索并列出Jira工单
  • 获取工单详情 - 获取详细的工单信息，包括评论
  • 更新工单描述 - 使用富文本格式更新工单描述
  • 添加评论 - 向工单添加带有Markdown支持的评论
  • 分配给我 - 将工单分配给当前用户
  • 移动工单 - 在不同状态之间移动工单
  • 在浏览器中打开工单 - 在默认的网络浏览器中打开Jira工单

快速开始

  1. 安装并配置jira-cli（安装指南）：

    # 安装jira-cli（macOS）
brew install ankitpokhrel/jira-cli/jira-cli

# 使用你的Jira实例配置jira-cli
jira init

  2. 安装jira-cli-mcp：

    brew tap choplin/jira-cli-mcp
brew install jira-cli-mcp

  3. 添加到Claude Desktop配置（参见下面的[设置]）

先决条件

  • 已安装并认证过的jira-cli
  • Bun运行时（仅开发或从源代码安装所需）

安装

方案1：通过Homebrew安装（macOS/Linux）

brew tap choplin/jira-cli-mcp
brew install jira-cli-mcp

方案2：通过npm安装

# 全局安装npm
npm install -g @choplin/jira-cli-mcp

# 或者使用Bun
bun install -g @choplin/jira-cli-mcp

方案3：下载二进制文件

从发布页面下载适用于您平台的预编译二进制文件：

  • macOS（Apple Silicon）：jira-cli-mcp-darwin-arm64.tar.gz
  • macOS（Intel）：jira-cli-mcp-darwin-x64.tar.gz
  • Linux（x64）：jira-cli-mcp-linux-x64.tar.gz
  • Linux（ARM64）：jira-cli-mcp-linux-arm64.tar.gz
# 示例针对macOS（Apple Silicon）
tar -xzf jira-cli-mcp-darwin-arm64.tar.gz
chmod +x jira-cli-mcp-darwin-arm64
sudo mv jira-cli-mcp-darwin-arm64 /usr/local/bin/jira-cli-mcp

方案4：从源代码构建

git clone https://github.com/choplin/jira-cli-mcp.git
cd jira-cli-mcp
bun install
bun run build:prod

Claude Desktop设置

方案1：使用Homebrew安装（推荐）

如果您是通过Homebrew安装的（如快速开始所示），请在您的claude_desktop_config.json中添加：

{
  "mcpServers": {
    "jira-cli": {
      "command": "jira-cli-mcp"
    }
  }
}

方案2：使用npm包

在您的claude_desktop_config.json中添加：

{
  "mcpServers": {
    "jira-cli": {
      "command": "npx",
      "args": ["@choplin/jira-cli-mcp"]
    }
  }
}

或者如果全局安装：

{
  "mcpServers": {
    "jira-cli": {
      "command": "jira-cli-mcp"
    }
  }
}

方案3：使用预编译二进制文件（无依赖）

  1. 从发布下载适用于您平台的二进制文件
  2. 解压并移动到您的PATH：
tar -xzf jira-cli-mcp-darwin-arm64.tar.gz
sudo mv jira-cli-mcp-darwin-arm64 /usr/local/bin/jira-cli-mcp
  1. 添加到配置：
{
  "mcpServers": {
    "jira-cli": {
      "command": "jira-cli-mcp"
    }
  }
}

方案4：从源代码构建

  1. 克隆并直接运行：
git clone https://github.com/choplin/jira-cli-mcp.git
cd jira-cli-mcp
bun install
  1. 添加到配置：
{
  "mcpServers": {
    "jira-cli": {
      "command": "bun",
      "args": ["run", "/path/to/jira-cli-mcp/src/index.ts"]
    }
  }
}

配置位置

配置文件通常位于：

  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux：~/.config/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json

验证

设置完成后，重启Claude Desktop，并检查MCP服务器是否已加载，可以通过询问Claude关于可用的Jira工具来验证。

其他AI助手的设置

Claude Code

Claude Code内置支持MCP服务器。要在项目中使用jira-cli-mcp：

  1. 首先使用安装部分中的方法之一安装jira-cli-mcp

  2. 在项目根目录下创建.claude/mcp.json文件：

{
  "servers": {
    "jira-cli": {
      "command": "jira-cli-mcp"
    }
  }
}
  1. 重启Claude Code，MCP服务器将自动加载

然后可以在对话中直接使用Jira命令，例如：

  • “列出我的开放Jira工单”
  • “显示PROJ-123的详细信息”
  • “向PROJ-456添加评论”

GitHub Copilot（VS Code）

GitHub Copilot支持Visual Studio Code中的MCP服务器（版本1.99+）：

  1. 首先使用安装部分中的方法之一安装jira-cli-mcp

  2. 在仓库中创建.vscode/mcp.json：

{
  "servers": {
    "jira-cli": {
      "command": "jira-cli-mcp"
    }
  }
}

  1. 在VS Code中打开.vscode/mcp.json文件并点击**[启动]**按钮以激活服务器

  2. 在Copilot Chat中：

    • 打开Copilot Chat面板
    • 从弹出菜单中选择“代理”
    • 点击工具图标查看可用的MCP服务器

注意：GitHub Copilot中的MCP支持目前处于公开预览阶段。

开发

运行测试

# 仅运行单元测试
bun test

# 运行所有测试，包括集成测试
bun run test:integration

# 使用特定测试工单运行集成测试
JIRA_CLI_MCP_TEST_TICKET=PROJ-123 bun run test:integration

环境变量

  • JIRA_CLI_PATH - 自定义jira-cli可执行文件路径（默认："jira"）

开发环境变量

  • JIRA_CLI_MCP_TEST_TICKET - 集成测试的工单键（非列表集成测试必需）
  • INTEGRATION_TEST=true - 启用集成测试

类型检查

b
bun run typecheck

代码检查和格式化

bun run lint
bun run format

架构

  • src/tools/ - MCP工具实现
  • src/utils/ - 共享实用程序和类型
  • tests/ - 使用模拟jira-cli的单元测试
  • tests/integration/ - 使用真实jira-cli的集成测试

注意事项

  • 该服务器使用Atlassian文档格式（ADF）处理富文本
  • Markdown输入会自动转换为ADF
  • 所有集成测试都需要正确的jira-cli认证

故障排除

常见问题

  1. "jira-cli未找到"错误

    • 确保已安装jira-cli：which jira
    • 如果使用自定义路径，请设置JIRA_CLI_PATH环境变量

  2. 认证错误

    • 运行jira me以验证认证
    • 如需重新认证，请使用jira init

  3. MCP服务器未出现在Claude Desktop中

    • 验证配置文件路径是否正确
    • 确保配置中的路径使用绝对路径而非相对路径
    • 配置更改后重启Claude Desktop

  4. macOS权限错误

    • 在系统偏好设置中授予终端/Claude Desktop完全磁盘访问权限
    • 确保jira-cli具有必要的权限

调试模式

要查看详细日志，可以手动运行服务器：

cd /path/to/jira-cli-mcp
bun run src/index.ts

许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。