Jira Issue MCP

An MCP (Model Context Protocol) server for looking up Jira issues, built with Bun, TypeScript, and the official MCP SDK.

Features

• MCP protocol compliant server for integration with Claude
• Stdio transport for direct communication with Claude Code
• Jira issue lookup by key
• Error handling and logging
• CLI interface with configuration options

Prerequisites

• Bun installed (v1.0.0 or higher)
• Jira API access (API Token)

Setup

1. Clone the repository:

   git clone https://github.com/yourusername/jira-issue-mcp.git
   cd jira-issue-mcp
   

2. Install dependencies:

   bun install
   

3. Create .env file from example:

   cp .env.example .env
   

4. Configure your Jira credentials in the .env file:

   JIRA_BASE_URL=https://your-domain.atlassian.net
   JIRA_EMAIL=your-email@example.com
   JIRA_API_TOKEN=your-api-token
   

5. (Optional) Build the executable:

   bun run build
   

Usage

Running the Server

Start the server:

bun start

For development with hot reload:

bun dev

Command Line Options

You can configure the application using command line options:

jira-issue-mcp [options]

Options:

• --jira-base-url <url> - Jira instance URL
• --jira-email <email> - Jira account email
• --jira-api-token <token> - Jira API token
• --log-level <level> - Logging level (debug, info, warn, error)
• --port <port> - Server port number
• --help, -h - Show help message

You can also use environment variables instead of CLI options.

Installation as a Global Command

After building, you can install the CLI globally:

npm link

Using with Claude Code

This MCP server is designed to work seamlessly with Claude Code. To use it, add the following configuration to your .mcp.json file:

{
  "mcpServers": {
    "jira-mcp": {
      "type": "stdio",
      "command": "bun",
      "args": [
        "run",
        "start"
      ],
      "env": {
        "JIRA_BASE_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your@email.com",
        "JIRA_API_TOKEN": "your-token"
      }
    }
  }
}

Once configured, you can use it directly in Claude Code to fetch Jira issues:

Fetch the jira issue PROJECT-123

Available Tools

get_issue

Retrieves a Jira issue by its key.

Parameters:

• issueKey (string): The Jira issue key (e.g., PROJECT-123)

Returns: A formatted JSON object containing the issue details, including:

• id
• key
• summary
• description
• status
• priority
• assignee
• reporter
• created/updated dates
• labels
• direct URL to the issue

Built With

• Bun - JavaScript runtime
• TypeScript - Type safety
• MCP SDK - Official MCP TypeScript SDK

License

MIT