MCP 服务器

jira-mcp

提供使用 JQL 搜索 Jira 问题并检索详细问题信息的功能。

AI集成系统

访问服务器

Tools

jql_search

Perform enhanced JQL search in Jira

get_issue

Retrieve details about an issue by its ID or key.

README

JIRA MCP 服务器

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

功能

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

前提条件

已安装 npm
具有 API 访问权限的 JIRA 实例
JIRA API 令牌或个人访问令牌
与 API 令牌关联的 JIRA 用户电子邮件

获取 JIRA API 凭据

登录到您的 Atlassian 帐户：https://id.atlassian.com
导航到安全设置
在 API 令牌下，选择“创建 API 令牌”
为您的令牌指定一个有意义的名称（例如，“MCP Server”）
复制生成的令牌 - 您将无法再次看到它！
使用此令牌作为您的 JIRA_API_KEY
使用与您的 Atlassian 帐户关联的电子邮件地址作为 JIRA_USER_EMAIL

用法

与 Claude Desktop 集成

将服务器配置添加到 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"
      }
    }
  }
}

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

可用工具

1. JQL 搜索 (`jql_search`)

执行具有可自定义参数的 JQL 搜索查询。

参数:

jql (必需): JQL 查询字符串
nextPageToken: 分页令牌
maxResults: 要返回的最大结果数
fields: 要包含的字段名称数组
expand: 要包含的其他信息

示例:

{
  "jql": "project = 'MyProject' AND status = 'In Progress'",
  "maxResults": 10,
  "fields": ["summary", "status", "assignee"]
}

2. 获取问题 (`get_issue`)

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

参数:

issueIdOrKey (必需): 问题 ID 或键
fields: 要包含的字段名称数组
expand: 要包含的其他信息
properties: 要包含的属性数组
failFast: 是否在错误时快速失败

示例:

{
  "issueIdOrKey": "PROJ-123",
  "fields": ["summary", "description", "status"],
  "expand": "renderedFields,names"
}

开发

配置

在运行服务器之前设置您的环境变量。在根目录中创建一个 .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 自动为 Claude Desktop 安装 JIRA：

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

手动安装

克隆此存储库：

git clone <repository-url>
cd jira-mcp

安装依赖项：

npm install

使用 MCP Inspector 运行

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

npm run inspect

添加新工具

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

server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      // 现有工具...
      {
        name: "your_new_tool",
        description: "Description of your new tool",
        inputSchema: {
          // 定义输入模式...
        }
      }
    ]
  };
});