jira-aio-mcp-server

jira-aio-mcp-server

0
developer_tools

AIO MCP Server is a Model Context Protocol server designed to facilitate interaction with the Jira AIO Test Case Management System. It allows users to access test case details, search for test cases, get project folder structures, and list all AIO projects using a variety of tools and comprehensive security measures.

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