Jira MCP 服务器

通过自然语言与 Jira 对话，获取项目信息并修改您的项目。将其与 Claude 桌面结合使用，并创建一个包含项目信息的自定义 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、名称、描述、子任务状态
// 不需要参数

3. 问题链接类型

// 列出所有可用的问题链接类型
// 返回：id、名称、 inward/outward 描述
// 不需要参数

4. 问题管理

获取问题

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

// 获取单个问题的详细信息
{
  issueIdOrKey: "issues/ABC-123"
}

创建问题

// 创建新问题
{
  method: POST,
  body: {
    fields: {
      project: { key: "project_key" },
      issuetype: { name: "Task" },
      title: "问题标题",
      description: "问题描述"
    }
  }
}

更新问题

// 更新现有问题
{
  method: PUT,
  body: {
    fields: {
      status: { name: "已解决" },
      priority: { name: "高" },
      assignee: { email: "user@example.com" }
    }
  }
}

删除问题

// 删除问题
{
  method: DELETE
}

描述字段

描述字段支持以下格式：

• 标题: 使用 # 标记标题，如 # 这是标题
• 段落: 直接输入文本即可，如 这是段落内容。
• 列表: 使用 - 创建无序列表，如：
  • 第一个列表项
  • 第二个列表项
• 代码块: 使用反引号 \ `` 包裹代码，如：

  console.log("Hello, World!");
  

• 强调: 使用 * 或 _ 创建强调文本，如 *这是强调文字*_
• 链接: 使用 [文本](URL) 创建超链接，如 [访问官网](https://www.example.com)

错误处理

• 400 错误: 请求格式有误或缺少参数
• 401 错误: 未授权，检查 API 令牌是否有效
• 404 错误: 资源不存在
• 500 错误: 服务器内部错误

设置指令

要使用此 MCP 服务器与 Claude 桡面：

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

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. 将 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 替换为您的克隆仓库的实际路径。

3. 重新启动 Claude 桡面以应用更改。

参考资料

• Model Context Protocol
• Jira REST API 文档
• Jira REST API 示例