remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows interaction with JIRA through JQL search queries and retrieving detailed issue information

JIRA MCP 服务器

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

特征

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

先决条件

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

获取 JIRA API 凭证

通过https://id.atlassian.com登录您的 Atlassian 帐户
导航至安全设置
在 API 令牌下，选择“创建 API 令牌”
给你的令牌一个有意义的名字（例如，“MCP 服务器”）
复制生成的令牌 - 您将无法再次看到它！
使用此令牌作为您的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: [
      // Existing tools...
      {
        name: "your_new_tool",
        description: "Description of your new tool",
        inputSchema: {
          // Define input schema...
        }
      }
    ]
  };
});

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

执照

麻省理工学院

贡献

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

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