一个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

JIRA MCP Server

An MCP server that enables Large Language Models (LLMs) to interact with JIRA through standardized tools and context. This server provides capabilities for searching issues using JQL and retrieving detailed issue information.

Features

• JQL Search: Execute complex JQL queries with pagination support
• Issue Details: Retrieve detailed information about specific JIRA issues

Prerequisites

• npm installed
• A JIRA instance with API access
• JIRA API token or Personal Access Token
• JIRA user email associated with the API token

Getting JIRA API Credentials

1. Log in to your Atlassian account at https://id.atlassian.com
2. Navigate to Security settings
3. Under API tokens, select “Create API token”
4. Give your token a meaningful name (e.g., “MCP Server”)
5. Copy the generated token - you won’t be able to see it again!
6. Use this token as your JIRA_API_KEY
7. Use the email address associated with your Atlassian account as JIRA_USER_EMAIL

Usage

Integration with Claude Desktop

1. Add the server configuration to Claude Desktop’s config file:

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": "[email protected]",
        "JIRA_API_KEY": "your-api-token"
      }
    }
  }
}

2. Restart Claude Desktop to load the new configuration.

Available Tools

1. JQL Search (jql_search)

Executes a JQL search query with customizable parameters.

Parameters:

• jql (required): JQL query string
• nextPageToken: Token for pagination
• maxResults: Maximum number of results to return
• fields: Array of field names to include
• expand: Additional information to include

Example:

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

2. Get Issue (get_issue)

Retrieves detailed information about a specific issue.

Parameters:

• issueIdOrKey (required): Issue ID or key
• fields: Array of field names to include
• expand: Additional information to include
• properties: Array of properties to include
• failFast: Whether to fail quickly on errors

Example:

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

Development

Configuration

Set up your environment variables before running the server. Create a .env file in the root directory: