jira MCP (Camden Clark)

JIRA MCP服务器

](https://smithery.ai/server/jira-mcp)

一个MCP服务器，使大型语言模型（LLM）能够通过标准化的工具和上下文与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 视窗: %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"
      }
    }
  }
}

1. 重新启动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安装

通过以下方式自动安装Claude Desktop的JIRA 史密瑟里:

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

手动安装

1. 克隆此存储库：

git clone 
cd jira-mcp

1. 安装依赖项：

npm install

使用MCP检查器运行

对于测试和开发，您可以使用MCP检查器：

npm run inspect

添加新工具

要添加新工具，请修改 ListToolsRequestSchema 处理程序在 index.js:

server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      // Existing tools...
      {
        name: "your_new_tool",
        description: "Description of your new tool",
        inputSchema: {
          // Define input schema...
        }
      }
    ]
  };
});

然后在 CallToolRequestSchema 处理程序。

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交PR。