JIRA API集成服务器

一个基于TypeScript的JIRA MCP服务器,为技术项目经理和工程师提供JQL搜索、问题检索和与模型上下文协议的无缝集成功能。

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

使用说明

JIRA MCP服务器

JIRA MCP服务器的TypeScript实现:面向技术项目经理和工程师的基本API集成

特性

  • JQL搜索功能
  • 按ID或密钥检索问题
  • 与模型上下文协议无缝集成

快速开始

使用npx安装并运行服务器:

npx @rujutaranade/likejarvis-jira-mcp-server
npm i likejarvis-jira-mcp-server

先决条件

  • Node.js(v18或更高版本)
  • 具有API访问权限的JIRA实例
  • JIRA API密钥/令牌

设置

  1. 克隆此存储库
  2. 安装依赖项:
    npm install
    
  3. 复制环境文件示例并填写您的JIRA凭据:
    cp .env.example .env
    
  4. 编辑 .env 带有JIRA实例URL、API密钥和用户电子邮件的文件

建立和运行

构建TypeScript代码:

npm run build

启动服务器:

npm start

对于自动重新加载的开发:

npm run dev

可用工具

1.JQL搜索(jql_search)

执行增强的JQL(JIRA查询语言)搜索以查找问题。

参数:

  • jql (必填):JQL查询字符串
  • nextPageToken:分页标记
  • maxResults:要返回的最大结果数(默认值:50)
  • fields:要包含在响应中的字段列表
  • expand:答复中应包括的补充信息

2.获取问题(get_issue)

检索有关特定问题的详细信息。

参数:

  • issueIdOrKey (必填):问题的ID或密钥
  • fields:响应中要包含的字段
  • expand:答复中应包括的补充信息
  • properties:要包含在响应中的属性
  • failFast:是否在出现错误时快速失败(默认值:false)

环境变量

  • JIRA_INSTANCE_URL:JIRA实例的URL
  • JIRA_API_KEY:您的JIRA API密钥/令牌
  • JIRA_USER_EMAIL:与您的JIRA帐户关联的电子邮件

许可证

麻省理工学院