Jira MCP Server Max

Jira MCP服务器最大值

  

用于Jira集成的强大的模型上下文协议（MCP）服务器，提供管理Jira项目、问题和批量操作的工具。用自然语言与Jira交谈，以获取有关项目的信息并对其进行修改。

使用 模型上下文协议.

将VS代码中的Jira MCP Server Max与Copilot连接的步骤（MCP集成）

1.克隆存储库

git clone https://github.com/Nipun-706/Jira-MCP-Server-Max.git
cd Jira-MCP-Server-Max
npm install
npm run build

2.在VS Code中打开项目

从项目的根目录启动VS Code。

3.触发MCP设置

• 按 Ctrl + Shift + P (Cmd + Shift + P 在Mac上）打开命令面板
• 搜索并选择 MCP：添加服务器

4.在.vcode/mcp.json中添加您的服务器

VS Code将打开（或创建） .vscode/mcp.json.添加此配置：

{
  "servers": {
    "my-mcp-server-2b4beb1a": {
      "name": "jira-server",
      "command": "node",
      "args": ["${workspaceFolder}/build/index.js"],
      "cwd": "${workspaceFolder}",
      "env": {
        "JIRA_HOST": "xxxx",
        "JIRA_EMAIL": "xxx",
        "JIRA_API_TOKEN": "xxx"
      },
      "type": "stdio"
    }
  }
}

要点：

• 使用 "node" 作为命令，因此它依赖于您安装的Node.js版本
• 使用 ${workspaceFolder} 避免硬编码路径并使其可移植
• 使用环境变量占位符或.env文件将API标记等敏感值排除在源代码管理之外

5.保存文件并添加服务器

保存后，您应该看到类似“添加服务器”的提示或VS Code已检测到您的MCP服务器的指示器。单击以连接。

6.应列出MCP服务器

在副驾驶/MCP面板中，您现在应该看到 jira-server 利用其可用的工具（例如。， get_projects, get_issues).

7.与服务器交互

现在，您可以让Copilot执行以下操作，例如：

• “列出Jira中的所有项目”
• “获取CCS项目中的问题”

它将利用您的MCP服务器来执行这些命令。

与Cline（替代MCP客户端）连接的步骤

1.克隆和设置存储库

git clone https://github.com/Nipun-706/Jira-MCP-Server-Max.git
cd Jira-MCP-Server-Max
npm install
npm run build

2.在VS代码中打开Cline

• 在VS代码中安装Cline扩展
• 在VS Code中打开您的项目

3.配置临床MCP设置

创建或编辑 cline_mcp_settings.json 在您的VS Code工作区中，使用以下配置：

{
  "mcpServers": {
    "jira-server": {
      "timeout": 60,
      "command": "D:/node/node.exe",
      "args": [
        "D:/coding/jira/Jira-MCP-Server/build/index.js"
      ],
      "cwd": "D:/coding/jira/Jira-MCP-Server",
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      },
      "type": "stdio",
      "disabled": false
    }
  }
}

配置说明：

• 替换 D:/node/node.exe 使用您实际的Node.js可执行路径
• 更新 args 和 cwd 匹配项目位置的路径
• 替换中的占位符值 env 使用您的实际Jira凭据
• 集 timeout 处理更长时间的操作需要60秒

4.应用配置

1. 保存 cline_mcp_settings.json 文件
2. 重新启动VS代码（或重新加载窗口： Ctrl+Shift+P → 重新加载窗口)
3. 在Cline的MCP面板中，验证 jira-server 显示为已启用
4. 如果服务器未连接，请检查Cline Output中的日志

5.测试集成

连接后，您可以使用自然语言与Cline进行交互：

• “显示CCS项目中的所有问题”
• “为登录问题创建新的错误报告”
• “列出分配给我的所有高优先级任务”

与Windsurf建立联系的步骤

1.克隆和设置存储库

git clone https://github.com/Nipun-706/Jira-MCP-Server-Max.git
cd Jira-MCP-Server-Max
npm install
npm run build

2.配置Windsurf MCP设置

将以下配置添加到Windsurf MCP设置中 "mcpServers" 对象：

{
  "mcpServers": {
    "jira-server": {
      "type": "stdio",
      "command": "D:/node/node.exe",
      "args": [
        "D:/coding/jira/Jira-MCP-Server/build/index.js"
      ],
      "cwd": "D:/coding/jira/Jira-MCP-Server",
      "timeout": 60,
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      },
      "disabledTools": [],
      "disabled": false
    }
  }
}

配置说明：

• 替换 D:/node/node.exe 使用您实际的Node.js可执行路径
• 更新 args 和 cwd 匹配项目位置的路径
• 替换中的占位符值 env 使用您的实际Jira凭据
• 集 timeout 处理更长时间的操作需要60秒
• 保持 disabledTools 空以启用所有可用工具

3.应用配置和测试

1. 保存您的Windsurf MCP配置
2. 重新启动Windsurf以应用更改
3. 核实一下 jira-server 出现在您的MCP服务器列表中
4. 使用自然语言命令进行测试，例如：

- “列出Jira实例中的所有项目” - “显示CCS项目中的未决问题” - “为API集成创建新任务”

可用工具

Jira MCP服务器提供以下工具：

核心工具

• get_项目 -列出所有Jira项目
• 获取问题 -获取JQL过滤的项目问题
• create_issues_bulk -一次创建多个Jira问题

配置

所需的环境变量：

• JIRA_HOST：您的Jira实例主机名
• JIRA_EMAIL：您的Jira帐户电子邮件
• JIRA_API_TOKEN：来自的API令牌https://id.atlassian.com/manage-profile/security/api-tokens

1.用户管理

// Get user's account ID by email
{
  email: "user@example.com";
}

2.问题类型管理

// List all available issue types
// Returns: id, name, description, subtask status
// No parameters required

3.问题链接类型

// List all available issue link types
// Returns: id, name, inward/outward descriptions
// No parameters required

4.问题管理

检索问题

// Get all issues in a project
{
  projectKey: "PROJECT"
}

// Get issues with JQL filtering
{
  projectKey: "PROJECT",
  jql: "status = 'In Progress' AND assignee = currentUser()"
}

// Get issues assigned to user
{
  projectKey: "PROJECT",
  jql: "assignee = 'user@example.com' ORDER BY created DESC"
}

制造问题

// Create a standard issue
{
  projectKey: "PROJECT",
  summary: "Issue title",
  issueType: "Task",  // or "Story", "Bug", etc.
  description: "Detailed description",
  assignee: "accountId",  // from get_user tool
  labels: ["frontend", "urgent"],
  components: ["ui", "api"],
  priority: "High"
}

// Create a subtask
{
  parent: "PROJECT-123",
  projectKey: "PROJECT",
  summary: "Subtask title",
  issueType: "Subtask",
  description: "Subtask details",
  assignee: "accountId"
}

更新问题

// Update issue fields
{
  issueKey: "PROJECT-123",
  summary: "Updated title",
  description: "New description",
  assignee: "accountId",
  status: "In Progress",
  priority: "High"
}

问题依赖关系

// Create issue link
{
  linkType: "Blocks",  // from list_link_types
  inwardIssueKey: "PROJECT-124",  // blocked issue
  outwardIssueKey: "PROJECT-123"  // blocking issue
}

删除问题

// Delete single issue
{
  issueKey: "PROJECT-123"
}

// Delete issue with subtasks
{
  issueKey: "PROJECT-123",
  deleteSubtasks: true
}

// Delete multiple issues
{
  issueKeys: ["PROJECT-123", "PROJECT-124"]
}

字段格式

描述字段

描述字段支持标记样式格式：

• 在段落之间使用空行
• 使用“-”表示要点
• 使用“1。“用于编号列表
• 使用以“：”结尾的标题（后跟空行）

例子：

Task Overview:

This task involves implementing new features:
- Feature A implementation
- Feature B testing

Steps:
1. Design component
2. Implement logic
3. Add tests

Acceptance Criteria:
- All tests passing
- Documentation updated

错误处理

服务器为以下对象提供详细的错误消息：

• 问题密钥无效
• 缺少必填字段
• 权限问题
• API费率限制

安装说明

1. 克隆存储库：

克隆https://github.com/Nipun-706/Jira-MCP-Server-Max.git cd Jira MCP服务器

2. Install dependencies:

npm install

3. 配置环境变量：
   创建一个 `.env` 根目录中的文件：

JIRA_HOST=your-instance.atlassian.net JIRA_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-token

1. 构建项目：

npm run build

1. 启动服务器：

npm start

## 配置Claude桌面

要将此MCP服务器与Claude Desktop一起使用：

1. 找到您的Claude Desktop配置文件：

   - macOS： `~/Library/Application Support/Claude/claude_desktop_config.json`
   - 窗户： `%APPDATA%/Claude/claude_desktop_config.json`
   - Linux： `~/.config/Claude/claude_desktop_config.json`

1. 将Jira MCP服务器添加到您的配置中：

{ "mcpServers": { "jira-server": { "name": "jira-server", "command": "/path/to/node", "args": ["/path/to/jira-server/build/index.js"], "cwd": "/path/to/jira-server", "env": { "JIRA_HOST": "your-jira-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token" } } } }

   替换 `/path/to/jira-server` 带有克隆存储库的绝对路径。
   替换 `/path/to/node` 使用Node.js可执行文件的绝对路径（通常可以通过运行 `which node` 或 `where node` 在您的终端中）。
   使用Node.js可执行文件和构建的JavaScript文件的直接路径(`build/index.js` 运行后 `npm run build`)为了确保可靠性，建议使用。

1. 重新启动Claude Desktop以应用更改。

## 配置光标

要将此Jira MCP服务器与Cursor一起使用，请执行以下操作：

1. **确保服务器已构建：** 跑 `npm run build` 在 `Jira-MCP-Server` 创建所需目录 `build/index.js` 文件。

1. **查找或创建Cursor的MCP配置文件：**

   - 对于项目特定配置： `.cursor/mcp.json` 在项目的根目录中。
   - 对于全局配置（所有项目）： `~/.cursor/mcp.json` 在您的主目录中。

1. **将Jira MCP服务器配置添加到 `mcp.json`:**

{ "mcpServers": { "jira-mcp-server": { "command": "node", // Or provide the absolute path to your Node.js executable "args": [ "/path/to/your/Jira-MCP-Server/build/index.js" // Absolute path to the server's built index.js ], "cwd": "/path/to/your/Jira-MCP-Server", // Absolute path to the Jira-MCP-Server directory "env": { "JIRA_HOST": "your-jira-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", // Your Jira email "JIRA_API_TOKEN": "your-api-token" // Your Jira API token } } // You can add other MCP server configurations here } }

   - 替换 `/path/to/your/Jira-MCP-Server` 使用克隆位置的正确绝对路径 `Jira-MCP-Server` 存储库。
   - 如果 `node` 不在系统的PATH中，或者您更喜欢绝对路径，请替换 `"node"` 使用Node.js可执行文件的完整路径（例如。， `/usr/local/bin/node` 或 `C:\Program Files\nodejs\node.exe`).
   - 确保您的Jira实例详细信息和API令牌正确填写在 `env` 部分。

1. **重新启动游标** 以应用更改。

### 在Jira上下文中使用游标规则

为了使与Jira的交互更加顺畅，您可以在Cursor的规则中定义默认的Jira项目和用户标识符。这有助于Cursor的AI理解您的上下文，而无需在每个提示中都指定它。

创建或编辑光标规则文件（例如，在项目中 `.cursor/rules.json` 或全球 `~/.cursor/rules.json` （规则的确切文件和方法可能会有所不同，请查看游标文档中的“规则”或“上下文管理”）。添加以下条目：

As an AI assistant, when I am asked about Jira tasks:

• Assume the primary Jira project key is 'YOUR_PROJECT_KEY_HERE'.
• Assume 'my assigned tasks' or tasks assigned to 'me' refer to the Jira user with the email 'your_jira_email@example.com' (or your Jira Account ID).

You can then use these in your JQL queries, for example: project = YOUR_PROJECT_KEY_HERE AND assignee = 'your_jira_email@example.com'.

替换 `YOUR_PROJECT_KEY_HERE` 和 `your_jira_email@example.com` 与您的实际细节。

### 光标聊天中的示例用法

配置后（特别是使用上下文的游标规则），您可以询问游标：

`"Using Jira MCP, list my assigned tasks. Then, based on these tasks, come up with an implementation plan and work schedule."`

如果你还没有设置规则，或者需要指定其他项目或用户，你会更明确：

`"Using Jira MCP, list tasks assigned to 'user@example.com' in project 'PROJECT_KEY'. Then, based on these tasks, come up with an implementation plan and work schedule."`

Cursor的AI将使用Jira MCP服务器获取任务，然后继续进行计划和调度请求。

### Amazon Q的设置

一次性步骤
克隆https://github.com/Nipun-706/Jira-MCP-Server-Max.git
cd Jira MCP服务器最大值
npm安装
npm运行构建

根据屏幕截图使用以下设置

如下所述更改红色高亮值

保持名称、传输、参数与屏幕截图相同
命令->添加系统的nodes-exe位置路径

## 参考文献

- [模型上下文协议](https://github.com/modelcontextprotocol)
- [Jira REST API文档](https://docs.atlassian.com/software/jira/docs/api/REST/7.12.0)
- [Jira REST API示例](https://developer.atlassian.com/server/jira/platform/jira-rest-api-examples/)