jira-aio-mcp-server

qamary666/jira-aio-mcp-server

3.2

If you are the rightful owner of jira-aio-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server for interacting with Jira AIO (All-in-One) Test Case Management System.

AIO MCP Server

A Model Context Protocol (MCP) server for interacting with Jira AIO (All-in-One) Test Case Management System.

Features

  • Get test case details from AIO
  • Search test cases by project and/or folders
  • Get folder structure of a project
  • Get list of all projects in AIO

Prerequisites

  • Node.js
  • Access to a Jira instance with AIO Test Case Management System
  • Jira API token

Installation

  1. Clone the repository
  2. Install dependencies:
npm install
  1. Build the project:
npm run build

Configuration

The server requires configuration through mcp.json. You can place this file either:

  • In your home directory: ~/.cursor/mcp.json
  • In the project root directory

Example mcp.json configuration:

{
  "jira-aio": {
    "command": "node",
    "args": ["/path/to/aio-server-mcp/build/index.js"],
    "env": {
      "JIRA_URL": "https://your-jira-instance:port",
      "JIRA_TOKEN": "your-base64-encoded-token"
    }
  }
}

Configuration Parameters

  • JIRA_URL: The URL of your Jira instance (including port if necessary)
  • JIRA_TOKEN: Your Jira API token for authentication

Available Tools

1. get_aio_testcase

Get detailed information about a specific test case.

  • Parameters:
    • projectKey: Project key in AIO (e.g., "AT")
    • testCaseKey: Test case key (e.g., "AT-TC-9")

2. search_aio_testcase

Search for test cases within a project and specific folders.

  • Parameters:
    • projectId: Project ID in AIO (e.g., 11502)
    • folderIds: (Optional) Array of folder IDs to search within

3. get_aio_folders

Retrieve the folder structure of a project.

  • Parameters:
    • projectId: Project ID in AIO (e.g., 11502)

4. get_aio_projects

Get a list of all available projects in AIO.

  • No parameters required

Error Handling

The server includes comprehensive error handling for:

  • API request failures
  • Authentication issues
  • Invalid configurations
  • Missing required parameters

Security

  • The server uses bearer token authentication
  • HTTPS connections are supported
  • Sensitive configuration can be provided through environment variables

Development

The server is built using:

  • TypeScript
  • Model Context Protocol SDK
  • Axios for HTTP requests