JIRA MCP 服务器

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

特征

• JQL 搜索：执行复杂的 JQL 查询并支持分页

• 问题详情：检索有关特定 JIRA 问题的详细信息

Related MCP server: Python Jira MCP Server

先决条件

• npm安装

• 具有 API 访问权限的 JIRA 实例

• JIRA API 令牌或个人访问令牌

• 与 API 令牌关联的 JIRA 用户电子邮件

获取 JIRA API 凭证

1. 通过https://id.atlassian.com登录您的 Atlassian 帐户

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": "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

手动安装

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: [
      // Existing tools...
      {
        name: "your_new_tool",
        description: "Description of your new tool",
        inputSchema: {
          // Define input schema...
        }
      }
    ]
  };
});

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

执照

麻省理工学院

贡献

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