JIRA MCP 服务器

一个MCP服务器，使大型语言模型（LLMs）能够通过标准化工具和上下文与JIRA交互。此服务器提供使用JQL搜索问题以及检索特定问题详细信息的功能。

功能

• JQL 搜索：执行复杂的JQL查询，支持分页
• 问题详细信息：检索特定JIRA问题的详细信息

先决条件

• 安装了 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

使用说明

与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'"
    },
    // 其他记录...
  ]
}

开发信息

安装指南

使用npm安装

npm install jira-mcp-server

手动安装

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

node index.js

配置

环境变量

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

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

许可证

MIT

贡献指南

欢迎贡献！请随时提交PR。