jira-cli-mcp CLAUDE.md

Jira CLI MCP Server Project Memory

Project Overview

MCP (Model Context Protocol) server that wraps the jira-cli command-line tool to enable AI assistants to interact with Jira.

Key Features

1. list_tickets - Search and list Jira tickets with semantic filters

   • Supports JQL queries and semantic parameters (assignedToMe, status, project, etc.)
   • Status enum includes: "open", "in progress", "in review", "done", "closed", "todo", "to do"

2. get_ticket - Get detailed ticket information

   • Parses ADF (Atlassian Document Format) to Markdown
   • Includes comments with pagination support

3. update_ticket_description - Update ticket descriptions

   • Accepts Markdown input (converted to ADF by jira-cli)

4. add_comment - Add comments to tickets

   • Supports rich text formatting via Markdown

5. assign_to_me - Assign tickets to current user

   • Uses jira me command to get current user

6. move_ticket - Move tickets between statuses

   • Maps lowercase status names to Jira status names

7. open_ticket_in_browser - Open tickets in default web browser

   • Uses jira open command to launch browser

Technical Details

• Runtime: Bun
• Language: TypeScript (strict mode, no any types)
• Testing: Separated unit tests (mocked) and integration tests
• Code Quality: Biome for linting/formatting, lefthook for git hooks
• Type Safety: Centralized status definitions in src/utils/types.ts

Project Structure

src/
├── index.ts          # MCP server entry point
├── config.ts         # Configuration management
├── tools/           # MCP tool implementations
└── utils/           # Shared utilities
    ├── types.ts     # Common types and status definitions
    ├── jiraExecutor.ts  # jira-cli command wrapper
    └── adf-types.ts # Atlassian Document Format types

tests/
├── *.test.ts        # Unit tests with mocks
└── integration/     # Integration tests with real jira-cli

Environment Variables