AI导哈

Jira查询服务器

一个只读的Jira MCP服务器，通过Jira REST API查询问题数据，支持多种认证方式和工具集配置。

  • by danglephuc
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 danglephuc/jira-mcp-server

使用说明

jira mcp服务器

A. 只读 模型上下文协议（MCP） 用于通过Jira REST API查询Jira问题数据的服务器。旨在与支持MCP的AI助手（如Claude、Cursor、GitHub Copilot）无缝集成。

特性

  • 🔍 Jira的只读访问权限 --列出问题、获取问题详细信息、下载附件、查询元数据
  • 🔐 灵活的身份验证 -电子邮件+API令牌（云）或用户名+密码（服务器/DC）
  • 📦 工具集系统 --仅启用所需的工具
  • 🔤 可配置的工具前缀 --避免多个MCP服务器之间的命名冲突
  • 🪙 令牌限制 --自动截断过大的响应以避免上下文溢出
  • 🚀 零本地安装 --直接通过运行 npx 不克隆repo

可用工具

工具集： issue

工具 描述 Jira端点
get_issues JQL筛选器的搜索问题 GET /rest/api/3/search
get_issue 获取一个包含完整细节的单一问题 GET /rest/api/3/issue/:issueKey
get_attachments 列出问题的附件 GET /rest/api/3/issue/:issueKey
download_attachment 以base64格式下载附件或流式传输到磁盘 GET /rest/api/3/attachment/:id +内容

工具集： issue_metadata

工具 描述 Jira端点
get_projects 列出所有可访问的项目 GET /rest/api/3/project/search
get_issue_types 列出所有问题类型 GET /rest/api/3/issuetype
get_issue_statuses 列出所有问题状态 GET /rest/api/3/status
get_priorities 列出所有问题优先级 GET /rest/api/3/priority
get_fields 列出所有字段（系统和自定义） GET /rest/api/3/field

工具前缀为 PREFIX （例如。， jira_get_issues).看 配置 了解详情。

快速开始

需求

  • Node.js 20+（使用内置 fetch ES模块）
  • 具有API访问权限的Jira Cloud帐户，或Jira服务器/数据中心实例
  • 有效的API令牌（云）或用户名+密码（服务器/DC）

安装（通过 npx)

将此添加到您的MCP客户端配置中（例如，Claude Desktop、Cursor等）：

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp-server"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

看 配置 对于所有可用的环境变量和CLI标志。

文档

文档 描述
配置 所有环境变量、CLI标志和身份验证选项
工具参考 每个工具的详细参数和示例
建筑 项目结构、关键模块和扩展指南
发展 如何运行、构建、测试和扩展此项目

发展

npm install
npm run dev          # run with tsx (hot reload)
npm run inspect      # launch MCP Inspector UI at http://localhost:6274
npm run build        # type-check and compile to build/
npm run test         # run all tests with vitest
npm run test:coverage  # run tests with coverage
npm run lint         # lint with eslint
npm run format       # check formatting with prettier

许可证

麻省理工学院

相关 MCP