AI导哈

Jira CLI MCP服务器

一个基于Model Context Protocol的服务器，通过包装jira-cli命令行工具使AI助手能够与Jira交互。

  • by choplin
  • TypeScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 choplin/jira-cli-mcp

使用说明

Jira CLI MCP服务器

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

为什么选择jira cli mcp？

如果您正在寻找Jira-MCP服务器，以下是Jira-cli-MCP的独特之处：

  • 🚀 利用现有工具 -与您现有的jira-cli设置和身份验证无缝协作
  • 🔒 安全第一 -配置文件中没有API令牌；由jira-cli处理的身份验证
  • 🪶 轻量级 -只需要一个Bun进程，不需要Docker或容器

何时改用mcp atlasian？

选择 mcp澳大利亚 如果你：

  • 需要 汇流 支持（我们只是Jira）
  • 更喜欢 码头工人 部署
  • 想要一个 独立的 不依赖CLI的解决方案
  • 需要 直接API 集成而不是CLI包装

特性

  • 创建_票 -使用可自定义字段创建新的Jira票证
  • list_tickets -使用JQL查询搜索和列出Jira票证
  • 获取门票 -获取详细的票务信息，包括评论
  • update_ticket_description -使用富文本格式更新票证描述
  • 添加注释 -使用Markdown支持为门票添加评论
  • assign_to_me -将票分配给当前用户
  • 移动票 -在不同状态之间移动票证
  • open_ticket_in_browser -在默认web浏览器中打开Jira票证

快速开始

  1. 安装和配置 吉拉cli (安装指南):

    # Install jira-cli (macOS)
brew install ankitpokhrel/jira-cli/jira-cli

# Configure jira-cli with your Jira instance
jira init

  2. 安装jira cli mcp：

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

  3. 添加到Claude Desktop配置（请参阅 设置 在......下面

先决条件

  • 吉拉cli 已安装并验证
  • 包子 运行时（仅在开发或从源代码安装时需要）

安装

选项1：通过Homebrew（macOS/Linux）安装

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

选项2：通过npm安装

# Install globally with npm
npm install -g @choplin/jira-cli-mcp

# Or with Bun
bun install -g @choplin/jira-cli-mcp

选项3：下载二进制文件

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

  • macOS（苹果硅）： jira-cli-mcp-darwin-arm64.tar.gz
  • macOS（英特尔）： 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
# Example for 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桌面设置

选项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
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json

验证

安装后，重新启动Claude Desktop，并通过询问Claude可用的Jira工具来检查MCP服务器是否已加载。

其他AI助手的设置

克劳德代码

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副本（VS代码）

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

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

  2. 创建 .vscode/mcp.json 在您的存储库中：

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

  1. 打开 .vscode/mcp.json 在VS Code中创建文件，然后单击 [开始] 激活服务器的按钮

  2. 在Copilot聊天中：

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

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

发展

运行测试

# Run unit tests only
bun test

# Run all tests including integration tests
bun run test:integration

# Run integration tests with a specific test ticket
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 -启用集成测试

类型检查

bun run typecheck

装订和格式化

bun run lint
bun run format

建筑

  • src/tools/ -MCP工具实现
  • src/utils/ -共享公用设施和类型
  • tests/ -使用模拟jira-cli进行单元测试
  • tests/integration/ -使用真实jira cli进行集成测试

备注

  • 服务器使用Atlassian文档格式（ADF）进行富文本处理
  • Markdown输入由jira-cli自动转换为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许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP