MCP 服务器

Jira MCP Server

通过模型上下文协议，实现与 Jira 的自然语言交互，从而管理项目、问题、任务和工作流程，允许用户通过 Claude Desktop 委派项目管理任务。

开发者工具

通信

JavaScript

访问服务器

Tools

delete_issue

Delete a Jira issue or subtask

get_issues

Get all issues and subtasks for a project

update_issue

Update an existing Jira issue

list_fields

List all available Jira fields

list_issue_types

List all available issue types

list_link_types

List all available issue link types

get_user

Get a user's account ID by email address

create_issue

Create a new Jira issue

create_issue_link

Create a link between two issues

README

Jira MCP 服务器

使用自然语言与 Jira 交互，获取和修改项目信息。将其与 Claude Desktop 结合使用，并配合您使用项目信息创建的自定义 README，以便您可以委派 PM 任务（例如，如果您有一个团队成员及其专业知识的列表，则将任何新问题分配给最相关的人员）。

基于 Model Context Protocol 构建。

该服务器支持：

项目创建和配置
问题和子任务管理
问题链接和依赖关系
自动化问题工作流程

配置

必需的环境变量：

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

可用工具

1. 用户管理

// 通过电子邮件获取用户的帐户 ID
{
  email: "user@example.com";
}

2. 问题类型管理

// 列出所有可用的问题类型
// 返回：id，name，description，subtask status
// 无需参数

3. 问题链接类型

// 列出所有可用的问题链接类型
// 返回：id，name，inward/outward descriptions
// 无需参数

4. 问题管理

检索问题

// 获取项目中的所有问题
{
  projectKey: "PROJECT"
}

// 使用 JQL 过滤获取问题
{
  projectKey: "PROJECT",
  jql: "status = 'In Progress' AND assignee = currentUser()"
}

// 获取分配给用户的问题
{
  projectKey: "PROJECT",
  jql: "assignee = 'user@example.com' ORDER BY created DESC"
}

创建问题

// 创建一个标准问题
{
  projectKey: "PROJECT",
  summary: "问题标题",
  issueType: "Task",  // 或 "Story", "Bug" 等
  description: "详细描述",
  assignee: "accountId",  // 来自 get_user 工具
  labels: ["frontend", "urgent"],
  components: ["ui", "api"],
  priority: "High"
}

// 创建一个子任务
{
  parent: "PROJECT-123",
  projectKey: "PROJECT",
  summary: "子任务标题",
  issueType: "Subtask",
  description: "子任务详情",
  assignee: "accountId"
}

更新问题

// 更新问题字段
{
  issueKey: "PROJECT-123",
  summary: "更新后的标题",
  description: "新的描述",
  assignee: "accountId",
  status: "In Progress",
  priority: "High"
}

问题依赖关系

// 创建问题链接
{
  linkType: "Blocks",  // 来自 list_link_types
  inwardIssueKey: "PROJECT-124",  // 被阻塞的问题
  outwardIssueKey: "PROJECT-123"  // 阻塞问题
}

删除问题

// 删除单个问题
{
  issueKey: "PROJECT-123"
}

// 删除包含子任务的问题
{
  issueKey: "PROJECT-123",
  deleteSubtasks: true
}

// 删除多个问题
{
  issueKeys: ["PROJECT-123", "PROJECT-124"]
}

字段格式

描述字段

描述字段支持 markdown 样式的格式：

段落之间使用空行
使用 "- " 表示项目符号
使用 "1. " 表示编号列表
使用以 ":" 结尾的标题（后跟空行）

示例：

任务概述:

此任务涉及实现新功能：
- Feature A 实现
- Feature B 测试

步骤:
1. 设计组件
2. 实现逻辑
3. 添加测试

验收标准:
- 所有测试通过
- 文档已更新

错误处理

服务器提供详细的错误消息，用于：

无效的问题键
缺少必需字段
权限问题
API 速率限制

安装说明

克隆存储库：

git clone https://github.com/George5562/Jira-MCP-Server.git
cd Jira-MCP-Server

安装依赖项：
```
npm install
```

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

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

构建项目：
```
npm run build
```
启动服务器：
```
npm start
```

配置 Claude Desktop

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

找到您的 Claude Desktop 配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json

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

{
  "mcp_servers": [
    {
      "name": "jira-server",
      "command": "npm start",
      "cwd": "/path/to/jira-server",
      "env": {
        "JIRA_HOST": "your-instance.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  ]
}