Jira MCP 服务器

使用自然语言与 Jira 对话，获取项目信息并进行修改。将其与 Claude Desktop 结合使用，并结合您创建的包含项目信息的自定义 README 文件，即可委派项目管理 (PM) 任务（例如，如果您有我的团队成员及其专长的列表，可以将任何新问题分配给最相关的人员）。

使用模型上下文协议构建。

该服务器支持：

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

配置

所需的环境变量：

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

Related MCP server: JIRA MCP Tools

可用工具

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"]
}

字段格式

描述字段

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

段落之间使用空行
使用“-”表示要点
使用“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 速率限制

设置说明

克隆存储库：

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 桌面

要将此 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"
      }
    }
  ]
}

将/path/to/jira-server替换为克隆存储库的绝对路径。

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

Jira MCP Server