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票证

快速开始

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

   # Configure jira-cli with your Jira instance
   jira init

1. 安装jira cli mcp：

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

1. 添加到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 安装 章节

1. 创建一个 .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 安装 章节

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

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

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

1. 在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 环境变量

1. 身份验证错误

- 跑 jira me 验证身份验证 - 重新验证 jira init 如有需要

1. MCP服务器未显示在Claude Desktop中

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

1. macOS上的权限错误

- 在“系统首选项”中授予终端/Claude Desktop全磁盘访问权限 - 确保jira-cli具有必要的权限

调试模式

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

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

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。