AI导哈

Jira集成服务器

Jira MCP Server是一个用于Jira集成的模型上下文协议服务器，使AI助手能够与Jira Cloud实例交互。

  • by sespinosa
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 sespinosa/jira-mcp-server

使用说明

Jira MCP服务器

用于Jira集成的模型上下文协议（MCP）服务器。该服务器使Claude等AI助手能够与Jira Cloud实例进行交互。

特性

  • 🎫 问题管理（创建、读取、更新、搜索）
  • 📋 项目列表
  • 🔍 JQL搜索功能
  • 🔐 API令牌身份验证
  • 📝 TypeScript实现
  • 🖥️ 跨平台支持（Windows、macOS、Linux）

系统要求

  • Node.js 18.x或更高版本
  • npm或纱线
  • Jira Cloud实例（不适用于Jira服务器/数据中心）

快速开始

1.安装

npm install

2.配置

创建一个 .env 项目根目录中的文件：

JIRA_HOST=your-domain.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token-here

3.生成API令牌

  1. 首选 Atlassian帐户设置
  2. 点击“创建API令牌”
  3. 给它一个有意义的标签
  4. 将令牌复制到您的 .env 文件

4.构建和运行

npm run build
npm start

可用工具

问题管理

  • jira_create_issue -创建新问题
  • jira_get_issue -获取详细的问题信息
  • jira_update_issue -更新问题字段
  • jira_search_issues -使用JQL搜索问题
  • jira_list_projects -列出所有可访问的项目

示例用法

创建问题

{
  "projectKey": "PROJ",
  "summary": "Fix login bug",
  "description": "Users cannot log in with special characters in password",
  "issueType": "Bug"
}

搜索问题

{
  "jql": "project = PROJ AND status = \"In Progress\" AND assignee = currentUser()",
  "maxResults": 20
}

获取问题详细信息

{
  "issueKey": "PROJ-123"
}

Claude桌面配置

将此添加到您的Claude Desktop MCP配置中：

macOS/Linux

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp-server/build/index.js"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

视窗

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["C:\\path\\to\\jira-mcp-server\\build\\index.js"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

认证

使用电子邮件+API令牌的基本身份验证。这是Jira Cloud最安全的方法。

错误处理

该服务器包括全面的错误处理功能，用于：

  • 无效凭证
  • 网络超时
  • JQL查询无效
  • 缺少权限
  • 不存在的资源

所有错误均以结构化格式返回，并附带有用消息。

发展

建筑

npm run build

测试

# Test the server
node build/index.js

故障排除

常见问题

  1. 服务器无法启动：

    • 检查你的 .env 文件配置正确
    • 验证您的API令牌是否有效
    • 确保Node.js版本为18+

  2. 权限错误：

    • 验证您的Jira用户是否具有适当的权限
    • 检查项目密钥是否存在并且可以访问

  3. 连接问题：

    • 验证您的Jira主机URL是否正确
    • 检查与Jira Cloud的网络连接

许可证

国际协调委员会

贡献

请看 贡献.md 了解如何为这个项目做出贡献的详细信息。

支持

对于问题和功能请求，请使用GitHub问题跟踪器。

相关 MCP