Kuvanov 2 MCP Server Jira

🚀 JIRA 的 MCP 服务器

此 Model Context Protocol (MCP) 服务器提供与 JIRA 的集成功能，可让 ChatGPT 或其他 AI 助手直接操作 JIRA 问题，极大提升了问题处理的效率和便捷性。

✨ 主要特性

此 MCP 服务器提供了实用的工具：

• get_issue：能够获取 JIRA 问题的详细信息。

📦 安装指南

# 克隆仓库
git clone https://github.com/kuvanov-2/mcp-server-jira.git
cd mcp-server-jira

# 安装依赖项
npm install

# 构建
npm run build

📚 详细文档

配置

使用 MCP 服务器前，需要完成以下设置：

1. 准备工作

1-1. 1Password CLI 设置

• 安装并运行 1Password 桌面应用。
• 安装 1Password CLI：

brew install 1password-cli

• 在 1Password（桌面应用）中启用 CLI 连接。

1-2. 获取 JIRA 的 API 令牌

• 从 此处 获取 JIRA API 令牌。
• 将 JIRA 的 API 令牌保存到 1Password 中。

2. Visual Studio Code 设置

• 打开配置文件：
  • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
• 添加以下配置：

{
  "mcpServers": {
    "github.com/kuvanov-2/mcp-server-jira": {
      "command": "/path/to/mcp-server-jira/start-server.sh",
      "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "op://YOUR_VAULT_NAME/YOUR_ITEM_NAME/info/access token" 
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

• 环境变量说明：
  • JIRA_HOST：JIRA 的主机 URL
  • JIRA_EMAIL：JIRA 账户的电子邮件地址
  • JIRA_API_TOKEN：1Password 中保存的 JIRA API 令牌的引用

JIRA 的 API TOKEN 假设已保存在 1Password 中。JIRA API Token 需要指定到 1Password 相关字段的路径，路径可通过右键点击字段并复制获得。

start-server.sh 脚本会自动使用 1Password CLI 解决环境变量，并启动服务器。

💻 使用示例

基础用法

get_issue

获取 JIRA 的问题详细信息。

<use_mcp_tool>
<server_name>github.com/kuvanov-2/mcp-server-jira</server_name>
<tool_name>get_issue</tool_name>
<arguments>
{
  "issueKey": "PROJ-123"
}
</arguments>
</use_mcp_tool>

📄 许可证

本项目采用 MIT 许可证。