JIRA MCP 服务器

JIRA MCP 服务器是一个连接 JIRA 项目管理工具与模型上下文协议功能的实用程序,提供了一套工具以编程方式与 JIRA 数据交互,使开发人员能够高效获取和管理 JIRA 资源。

  • by ennbou
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ennbou/jiramcpserver

使用说明

JIRA MCP服务器

JIRA MCP服务器旨在简化JIRA与模型上下文协议的集成。

概述

JIRA MCP Server是一个将JIRA项目管理工具与模型上下文协议功能连接起来的实用程序,允许在开发工作流程中增强上下文感知。它提供了一组以编程方式与JIRA数据交互的工具,使开发人员能够高效地获取和管理JIRA资源。

可用的MCP工具

JIRA MCP服务器中提供以下工具:

  • 按关键字获取jira问题详细信息:按键获取JIRA问题详细信息。
  • 在项目中获取jira用户:获取项目中的JIRA用户。
  • 通过jcl获取jira问题:使用JQL获取JIRA问题。
  • 在项目中获取jira组件:获取项目中的JIRA组件。
  • 在项目中获得jira状态:获取项目中的JIRA状态。
  • 确定吉拉的优先事项:获取JIRA优先级。
  • 获取jira项目:获取JIRA项目。
  • 使用项目id或项目密钥获取jira板:按ID或键获取项目中的JIRA板。
  • 使用板名获取jira板:按名字取JIRA板。
  • 在项目中获取jira问题类型:获取项目中的JIRA问题类型。
  • 让吉拉参加冲刺:让JIRA在板上冲刺。

由于它正在测试中,因此它是只读的,不支持其他HTTP操作(如:PUT、POST、DELETE)。

先决条件

在开始之前,请确保已安装以下内容:

  • Node.js (v16或更高版本)
  • npm (v8或更高)
  • 酿造 (安装gitleaks,仅适用于macOS)

安装

  1. 克隆存储库:

    git clone <repository-url>
    cd jriamcpserver
    
  2. 安装依赖项:

    npm install
    
  3. 构建项目:

    npm run build
    

配置

创建一个 .env 根目录中的文件,包含以下环境变量:

JIRA_HOSTNAME="jira.xxxx.com"
JIRA_AUTH_TOKEN="XXXXXXX+token+EYVzV"

构建服务器

npm run build

运行服务器

有两种方法可以运行服务器:

npm start

检查器模式

要使用MCP检查器进行调试,请执行以下操作:

npm run inspector

了解更多详情(读)

VS代码集成

要将此MCP服务器添加到Visual Studio代码中,建议使用第一种方法。

要将此MCP服务器添加到Visual Studio代码中,请运行以下命令:

code --add-mcp '{"name":"jiramcpserver", "envFile": "{$JIRA_MCP_SERVER_PATH/.env","type": "stdio","command": "node","args": ["$JIRA_MCP_SERVER_PATH/build/"]}'

别忘了换衣服 $JIRA_MCP_SERVER_PATH

或者,您可以通过VS Code接口添加它:

  1. 按Cmd+Shift+P

  2. 类型 MCP: List servers,单击 Enter

  3. 点击 + add server

  4. 选择 Command (stdio)

  5. 进入 node "$JIRA_MCP_SERVER_PATH/build/index.js"

您仍然需要JIRA服务器凭据。尝试将它们添加到您的环境中, 或尝试打开VS Code设置JSON并添加 envFile 到 mcp.servers.jiramcpserver:

  "mcp": {
    "servers": {
        "my-jira-mcp-server": {
            "envFile": "PATH_OF_.env",
            "type": "stdio",
            "command": "node",
            "args": [
                "...../build/"
            ]
        }
    }
  }

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。