🚀 JIRA MCP 服务器

JIRA MCP 服务器是一个 MCP 服务器，它让大型语言模型（LLMs）能借助标准化工具和上下文与 JIRA 进行交互。此服务器具备使用 JQL 搜索问题以及检索特定问题详细信息的功能，为用户在 JIRA 系统中高效获取信息提供了便利。

🚀 快速开始

若要使用 JIRA MCP 服务器，需完成以下先决条件的准备：

• 安装了 npm
• 带有 API 访问权限的 JIRA 实例
• JIRA API 令牌或个人访问令牌
• 与 API 令牌关联的 JIRA 用户电子邮件地址

获取 JIRA API 凭证

1. 登录到您的 Atlassian 账户：https://id.atlassian.com
2. 转到安全设置。
3. 在 API 令牌下，选择“创建 API 令牌”。
4. 给令牌提供一个有意义的名字（例如，“MCP 服务器”）。
5. 复制生成的令牌——您将无法再次看到它！
6. 使用此令牌作为您的 JIRA_API_KEY。
7. 使用与 Atlassian 账户关联的电子邮件地址作为 JIRA_USER_EMAIL。

✨ 主要特性

• JQL 搜索：可执行复杂的 JQL 查询，并且支持分页功能，方便用户按需求获取问题列表。
• 问题详细信息：能够检索特定 JIRA 问题的详细信息，包括问题的描述、标签、评论、历史记录等。

📦 安装指南

使用 npm 安装

npm install jira-mcp-server

手动安装

1. 下载最新版本的压缩包。
2. 解压文件到目标目录。
3. 运行服务器：

node index.js

💻 使用示例

与 Claude Desktop 集成

1. 将服务器配置添加到 Claude Desktop 的配置文件中：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp"],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net",
        "JIRA_USER_EMAIL": "your-email@company.com",
        "JIRA_API_KEY": "your-api-token"
      }
    }
  }
}

2. 重新启动 Claude Desktop 以加载新的配置。

可用工具

1. JQL 搜索 (jql_search)

执行带有自定义参数的 JQL 查询。 输入示例：

{
  "command": "jql_search",
  "issueQuery": "project = ABC AND status = 'In Progress'",
  "maxResults": 50,
  "startIndex": 0
}

输出示例：

{
  "issues": [
    {
      "id": "1234",
      "key": "ABC-123",
      "title": "Implement New Feature",
      "status": "In Progress",
      "priority": "High",
      "assignee": "张三"
    },
    // 其他问题...
  ],
  "total": 100
}

2. 检索问题详细信息 (get_issue)

检索特定问题的详细信息。 输入示例：

{
  "command": "get_issue",
  "issueIdOrKey": "ABC-123"
}

输出示例：

{
  "id": "1234",
  "key": "ABC-123",
  "title": "Implement New Feature",
  "status": "In Progress",
  "priority": "High",
  "assignee": "张三",
  "description": "需要实现新功能...",
  "labels": ["feature", "urgent"],
  "comments": [
    {
      "id": "5678",
      "author": "李四",
      "content": "请优先处理此问题。",
      "createdAt": "2023-10-01T12:00:00Z"
    },
    // 其他评论...
  ],
  "history": [
    {
      "actionDate": "2023-10-01T10:00:00Z",
      "action": "status changed to 'In Progress'"
    },
    // 其他记录...
  ]
}

📚 详细文档

配置

环境变量

创建一个 .env 文件并添加以下内容：

JIRA_INSTANCE_URL=https://your-instance.atlassian.net
JIRA_USER_EMAIL=your-email@company.com
JIRA_API_KEY=your-api-token

📄 许可证

本项目采用 MIT 许可证。

🤝 贡献指南

欢迎大家为项目贡献代码！请随时提交 PR。