Jira Cloud MCP Server

A Model Context Protocol server for interacting with Jira Cloud instances.

Quick Start

Installation

To use this MCP server, add the server configuration to your MCP settings:

{
  "mcpServers": {
    "jira-cloud": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "JIRA_EMAIL",
        "-e", "JIRA_HOST",
        "-e", "JIRA_API_TOKEN",
        "ghcr.io/aaronsb/jira-cloud:latest"
      ],
      "env": {
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_EMAIL": "your-email",
        "JIRA_HOST": "your-team.atlassian.net"
      }
    }
  }
}

For detailed installation instructions, see the Getting Started Guide.

Key Features

• Issue Management: Create, retrieve, update, and comment on Jira issues
• Search Capabilities: JQL search with filtering
• Project & Board Management: List and manage projects, boards, and sprints
• MCP Resources: Access Jira data as context through MCP resources
• Customization: Support for custom fields and workflows

Architecture

The server is built with a modular architecture:

src/
├── client/       # Core Jira API client
├── handlers/     # MCP tool handlers
├── schemas/      # JSON schemas for tools
├── types/        # TypeScript definitions
├── utils/        # Utility functions
└── index.ts      # Server entry point

Documentation

Essential documentation is available in the docs/ directory:

• Getting Started - Setup and installation
• API Reference - Available tools and usage
• Resources - Available MCP resources
• Troubleshooting - Common issues and solutions
• Development - Development guide

License

MIT License