金大哥 - Jira-MCP-Server MCP 详情

article

README

🚀 Jira MCP 服务器

Jira MCP 服务器允许您通过自然语言与 Jira 进行对话，轻松获取项目信息并对项目进行修改。它可以与 Claude 桌面结合使用，还能创建包含项目信息的自定义 README，助力您委托 PM 任务。例如，若您有团队成员及其专长列表，就能将新问题分配给最适合的人员。该服务器基于 Model Context Protocol 构建。

🚀 快速开始

若要使用此 MCP 服务器与 Claude 桌面交互，可按以下步骤操作：

找到您的 Claude 桌面配置文件：
- 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 桌面以应用更改。

✨ 主要特性

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

📦 安装指南

所需环境变量：

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)

Jira-MCP-Server