JIRA MCP 服务器

这是一个 MCP 服务器，使大型语言模型（LLMs）能够通过标准化工具和上下文与 JIRA 进行交互。此服务器提供了使用 JQL 搜索问题并获取详细问题信息的功能。

<a href="https://glama.ai/mcp/servers/4e3sqj7af1"><img width="380" height="200" src="https://gips3.baidu.com/it/u=3494399671,1547490156&fm=3081&app=3081&f=PNG?w=760&h=400" alt="jira-mcp MCP 服务器" /></a>

功能

• 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 搜索查询。

参数：

• jql（必需）：JQL 查询字符串
• nextPageToken：分页标记
• maxResults：返回的最大结果数
• fields：要包含的字段名称数组
• expand：要包含的附加信息

示例：

{
  "jql": "项目 = 'MyProject' 并且 状态 = '进行中'",
  "maxResults": 10,
  "fields": ["摘要", "状态", "分配给"]
}

2. 获取问题 (get_issue)

检索特定问题的详细信息。

参数：

• issueIdOrKey（必需）：问题 ID 或键
• fields：要包含的字段名称数组
• expand：要包含的附加信息
• properties：要包含的属性数组
• failFast：是否在遇到错误时快速失败

示例：

{
  "issueIdOrKey": "PROJ-123",
  "fields": ["摘要", "描述", "状态"],
  "expand": "渲染字段,名称"
}

开发

配置

在运行服务器之前设置环境变量。在根目录创建一个 .env 文件：

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

替换值为：

• 您的实际 JIRA 实例 URL
• 与您的 JIRA 账户关联的电子邮件地址
• 您的 JIRA API 密钥（可以在 Atlassian 账户设置中生成）

安装

通过 Smithery 安装

要通过 Smithery 自动安装 JIRA for Claude Desktop：

npx -y @smithery/cli install jira-mcp --client claude

手动安装

1. 克隆此仓库：

git clone <repository-url>
cd jira-mcp

2. 安装依赖项：

npm install

使用 MCP Inspector 运行

对于测试和开发，您可以使用 MCP Inspector：

npm run inspect

添加新工具

要添加新工具，请修改 index.js 中的 ListToolsRequestSchema 处理程序：

server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      // 已存在的工具...
      {
        name: "your_new_tool",
        description: "新工具的描述",
        inputSchema: {
          // 定义输入模式...
        }
      }
    ]
  };
});

然后在 CallToolRequestSchema 处理程序中实现该工具。

许可证

MIT

贡献

欢迎贡献！请随意提交 PR。 </中文翻译>