jira-log-mcp

A Model Context Protocol server for reading and filtering Jira log files in plugin development environments.

Features

Efficient Log Reading: Reads Jira log files directly from the filesystem, avoiding the need to capture terminal output.

Smart Filtering: Automatically filters out common noise patterns like LuceneConsistencyChecker messages, LESS compiler warnings, and health check notifications.

Plugin Development Focus: Designed specifically for Jira plugin development workflows where you need to monitor atlassian-jira.log files.

Easy Integration: Built with minimal dependencies and designed to work seamlessly with Claude Desktop and other MCP clients.

Tools

• read_log_output - Reads and filters lines from Jira log files, with automatic detection of standard Jira plugin development log locations.

Requirements

• Node version 18 or greater
• A Jira plugin development environment with log files at target/jira/home/log/atlassian-jira.log

Installation

To use with Claude Desktop, add the server config:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jira-log-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "jira-log-mcp"
      ]
    }
  }
}

Usage

The server automatically detects Jira log files in standard plugin development locations:

• ./target/jira/home/log/atlassian-jira.log
• process.cwd()/target/jira/home/log/atlassian-jira.log

You can also specify a custom log file path using the logSource parameter.

Default Filtering

By default, the following patterns are filtered out to reduce noise:

• LuceneConsistencyChecker
• RestApiModulesService
• /rest/wrm/2.0/resources
• Consider switching to the \less` compiler from npmjs`
• SupportHealthCheckProcess

You can override these filters by providing your own skipLines array.

Development

Install dependencies:

yarn install

Build the server:

yarn run build

For development with auto-rebuild:

yarn run watch

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

yarn run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Testing

Run the test suite:

yarn run test

Run tests in watch mode:

yarn run test:watch

Run tests with coverage:

yarn run test:coverage