Jira Insights

by aaronsb

Not rated
GitHub

About

Enables programmatic management of Jira Insights asset schemas through CRUD operations on object types and AQL queries, streamlining IT asset management and configuration tracking workflows.

Details

Author
aaronsb
Repository
aaronsb/jira-insights-mcp
Categories
Productivity, Project Management, Developer Tools, Design, Workplace, AI, Search, Infrastructure, Communication, Security, Frontend

Jump to

- Manage object schemas (create, read, update, delete)
- Manage object types (create, read, update, delete)
- Manage objects (create, read, update, delete)
- Query objects using AQL (Atlassian Query Language)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Jira Insights
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 /path/to/jira-insights-mcp/build/index.js
    Environment
    • LOG_MODE strict
    • JIRA_HOST https://your-domain.atlassian.net
    • JIRA_EMAIL your-email@example.com
    • JIRA_API_TOKEN your-api-token

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

To use this MCP server with Claude or other AI assistants that support the Model Context Protocol, add it to your MCP configuration using one of the following methods:

If you've built the project locally, use this configuration:

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

If you prefer to use the Docker image (recommended for most users), use this configuration:

{
  "mcpServers": {
    "jira-insights": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "JIRA_API_TOKEN",
        "-e", "JIRA_EMAIL",
        "-e", "JIRA_HOST",
        "ghcr.io/aaronsb/jira-insights-mcp:latest"
      ],
      "env": {
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_HOST": "https://your-domain.atlassian.net"
      }
    }
  }
}

This Docker-based configuration pulls the latest image from GitHub Container Registry and runs it with the necessary environment variables.

For local development and testing:

```bash

manage_jira_insight_schema

Manage Jira Insights object schemas with CRUD operations. Parameters: operation (string), maxResults (integer)

manage_jira_insight_object_type

Manage Jira Insights object types with CRUD operations. Parameters: operation (string), schemaId (string), maxResults (integer)

manage_jira_insight_object

Manage Jira Insights objects with CRUD operations and AQL queries. Parameters: operation (string), aql (string), maxResults (integer)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

Jira Insights MCP

A Model Context Protocol (MCP) server for managing Jira Insights (JSM) asset schemas.

Last updated: 2025-04-09

Overview

This MCP server provides tools for interacting with Jira Insights (JSM) asset schemas through the Model Context Protocol. It allows you to manage object schemas, object types, and objects in Jira Insights.

Features

- Manage object schemas (create, read, update, delete)
- Manage object types (create, read, update, delete)
- Manage objects (create, read, update, delete)
- Query objects using AQL (Atlassian Query Language)

Prerequisites

- Node.js 20 or later
- Docker (for containerized deployment)
- Jira Insights instance with API access
- Jira API token with appropriate permissions

Installation

Local Development

1. Clone the repository:

   git clone https://github.com/aaronsb/jira-insights-mcp.git

   cd jira-insights-mcp

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Docker

Build the Docker image:

./scripts/build-local.sh

Usage

MCP Configuration

To use this MCP server with Claude or other AI assistants that support the Model Context Protocol, add it to your MCP configuration using one of the following methods:

Local Build Configuration

If you've built the project locally, use this configuration:

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

Docker-based Configuration

If you prefer to use the Docker image (recommended for most users), use this configuration:

{
  "mcpServers": {
    "jira-insights": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "JIRA_API_TOKEN",
        "-e", "JIRA_EMAIL",
        "-e", "JIRA_HOST",
        "ghcr.io/aaronsb/jira-insights-mcp:latest"
      ],
      "env": {
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_HOST": "https://your-domain.atlassian.net"
      }
    }
  }
}

This Docker-based configuration pulls the latest image from GitHub Container Registry and runs it with the necessary environment variables.

Running Locally for Development

For local development and testing:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Install

Add to Claude Desktop or Cursor

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

More like this

Similar MCP servers you might find useful

Browse category

Time

A Model Context Protocol server that provides time and timezone conversion capabilities. It enables LLMs to get current time information and perform timezone…

88.2k
Productivity

Git

A Model Context Protocol (MCP) server that provides tools for LLMs to read, search, and manipulate Git repositories. It enables automated repository…

88.1k
Developer Tools

Context 7

Official Context7 MCP server that brings up-to-date, version-specific library documentation and code examples into AI coding prompts.

58.7k
Developer Tools