{"_id":"@choplin/jira-cli-mcp","_rev":"4-5bfc00a878e64099ef972faf3eb375bc","name":"@choplin/jira-cli-mcp","dist-tags":{"latest":"0.4.0"},"versions":{"0.2.0":{"name":"@choplin/jira-cli-mcp","version":"0.2.0","keywords":["mcp","jira","jira-cli","modelcontextprotocol","ai","claude"],"author":{"name":"Akihiro Okuno"},"license":"Apache-2.0","_id":"@choplin/jira-cli-mcp@0.2.0","maintainers":[{"name":"choplin","email":"choplin.choplin@gmail.com"}],"homepage":"https://github.com/choplin/jira-cli-mcp#readme","bugs":{"url":"https://github.com/choplin/jira-cli-mcp/issues"},"bin":{"jira-cli-mcp":"dist/index.js"},"dist":{"shasum":"769a6f59855727b4496663384f39b9a5e4750520","tarball":"https://registry.npmjs.org/@choplin/jira-cli-mcp/-/jira-cli-mcp-0.2.0.tgz","fileCount":4,"integrity":"sha512-DLjbg6qoRHzutbBgSQFaBDjEpnom2AwAq30yCoXhCGFThVkrzmNz1ss7fJj1Tfe6Pyy2WUgYUQH6PM1+jPb9pw==","signatures":[{"sig":"MEUCIQCvacGUH1m2s1nyDZJXCB62sjOL4TKrXylxoUW8iZHYXQIgC/YZ5kXTeoXIEF468F0sSTZB3GYvVTe44uUd6PGwCcQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":147333},"main":"dist/index.js","type":"module","module":"dist/index.js","engines":{"node":">=18.0.0"},"gitHead":"ce6c73ea63eb813f68352566ed1ed54a3f030bb4","scripts":{"ci":"bun run check && bun run typecheck && bun test && bun run build","dev":"bun --watch run src/index.ts","lint":"biome lint src/","test":"bun test tests/","build":"rm -rf dist && bun build --target=bun --outdir=dist --sourcemap src/index.ts","check":"biome check src/","start":"bun run src/index.ts","format":"biome format --write src/","lint:md":"markdownlint-cli2 '**/*.md' '#node_modules'","prepare":"lefthook install","lint:fix":"biome lint --write src/","build:tsc":"rm -rf dist && tsc -p tsconfig.build.json","check:fix":"biome check --write src/","typecheck":"tsc --noEmit","build:prod":"rm -rf dist && bun build --target=bun --outdir=dist --minify --sourcemap=none src/index.ts","lint:md:fix":"markdownlint-cli2 --fix '**/*.md' '#node_modules'","build:binaries":"bun run build:binary:darwin-arm64 && bun run build:binary:darwin-x64 && bun run build:binary:linux-x64 && bun run build:binary:linux-arm64","test:integration":"INTEGRATION_TEST=true bun test tests/integration/","build:binary:linux-x64":"bun build --compile --target=bun-linux-x64 --minify --sourcemap=none --outfile=jira-cli-mcp-linux-x64 src/index.ts","build:binary:darwin-x64":"bun build --compile --target=bun-darwin-x64 --minify --sourcemap=none --outfile=jira-cli-mcp-darwin-x64 src/index.ts","build:binary:linux-arm64":"bun build --compile --target=bun-linux-arm64 --minify --sourcemap=none --outfile=jira-cli-mcp-linux-arm64 src/index.ts","build:binary:darwin-arm64":"bun build --compile --target=bun-darwin-arm64 --minify --sourcemap=none --outfile=jira-cli-mcp-darwin-arm64 src/index.ts"},"_npmUser":{"name":"choplin","email":"choplin.choplin@gmail.com"},"repository":{"url":"git+https://github.com/choplin/jira-cli-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server that wraps jira-cli for AI assistants","directories":{},"_nodeVersion":"20.19.1","dependencies":{"zod":"^3.25.49","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"lefthook":"^1.11.13","@types/bun":"^1.2.15","@types/node":"^22.15.29","@biomejs/biome":"^1.9.4","@commitlint/cli":"^19.8.1","markdownlint-cli2":"^0.18.1","@commitlint/config-conventional":"^19.8.1"},"peerDependencies":{"typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/jira-cli-mcp_0.2.0_1749126809692_0.6173134546675543","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@choplin/jira-cli-mcp","version":"0.2.1","keywords":["mcp","jira","jira-cli","modelcontextprotocol","ai","claude"],"author":{"name":"Akihiro Okuno"},"license":"Apache-2.0","_id":"@choplin/jira-cli-mcp@0.2.1","maintainers":[{"name":"choplin","email":"choplin.choplin@gmail.com"}],"homepage":"https://github.com/choplin/jira-cli-mcp#readme","bugs":{"url":"https://github.com/choplin/jira-cli-mcp/issues"},"bin":{"jira-cli-mcp":"dist/index.js"},"dist":{"shasum":"8cbe51e00facc1e9f047dfec30c57cbb86edac96","tarball":"https://registry.npmjs.org/@choplin/jira-cli-mcp/-/jira-cli-mcp-0.2.1.tgz","fileCount":4,"integrity":"sha512-j7URu+A2ujXMht2XyE9syAGkiPsWumL1dPanyxgaPET6wxuKUC90Nk696MqyfTZAglqOr3T9b9LabM+cG0xoKQ==","signatures":[{"sig":"MEQCIBGgLMrKHIL/DQbdCCV7wF/jTOhm3pohJh6YOVrBpiWpAiAiy0jiGLhwfF1SLpQmy1+LfQwzOnQE634cYzwLg4Reew==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":147226},"main":"dist/index.js","type":"module","module":"dist/index.js","engines":{"node":">=18.0.0"},"gitHead":"4af74c550e2064d58fdbbe486db0200540633917","scripts":{"ci":"bun run check && bun run typecheck && bun test && bun run build","dev":"bun --watch run src/index.ts","lint":"biome lint src/","test":"bun test tests/","build":"rm -rf dist && bun build --target=bun --outdir=dist --sourcemap src/index.ts","check":"biome check src/","start":"bun run src/index.ts","format":"biome format --write src/","lint:md":"markdownlint-cli2 '**/*.md' '#node_modules'","prepare":"lefthook install","lint:fix":"biome lint --write src/","build:tsc":"rm -rf dist && tsc -p tsconfig.build.json","check:fix":"biome check --write src/","typecheck":"tsc --noEmit","build:prod":"rm -rf dist && bun build --target=bun --outdir=dist --minify --sourcemap=none src/index.ts","lint:md:fix":"markdownlint-cli2 --fix '**/*.md' '#node_modules'","build:binaries":"bun run build:binary:darwin-arm64 && bun run build:binary:darwin-x64 && bun run build:binary:linux-x64 && bun run build:binary:linux-arm64","test:integration":"INTEGRATION_TEST=true bun test tests/integration/","build:binary:linux-x64":"bun build --compile --target=bun-linux-x64 --minify --sourcemap=none --outfile=jira-cli-mcp-linux-x64 src/index.ts","build:binary:darwin-x64":"bun build --compile --target=bun-darwin-x64 --minify --sourcemap=none --outfile=jira-cli-mcp-darwin-x64 src/index.ts","build:binary:linux-arm64":"bun build --compile --target=bun-linux-arm64 --minify --sourcemap=none --outfile=jira-cli-mcp-linux-arm64 src/index.ts","build:binary:darwin-arm64":"bun build --compile --target=bun-darwin-arm64 --minify --sourcemap=none --outfile=jira-cli-mcp-darwin-arm64 src/index.ts"},"_npmUser":{"name":"choplin","email":"choplin.choplin@gmail.com"},"repository":{"url":"git+https://github.com/choplin/jira-cli-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server that wraps jira-cli for AI assistants","directories":{},"_nodeVersion":"20.19.1","dependencies":{"zod":"^3.25.49","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"lefthook":"^1.11.13","@types/bun":"^1.2.15","@types/node":"^22.15.29","@biomejs/biome":"^1.9.4","@commitlint/cli":"^19.8.1","markdownlint-cli2":"^0.18.1","@commitlint/config-conventional":"^19.8.1"},"peerDependencies":{"typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/jira-cli-mcp_0.2.1_1749131243919_0.7363434564667632","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@choplin/jira-cli-mcp","version":"0.3.0","keywords":["mcp","jira","jira-cli","modelcontextprotocol","ai","claude"],"author":{"name":"Akihiro Okuno"},"license":"MIT","_id":"@choplin/jira-cli-mcp@0.3.0","maintainers":[{"name":"choplin","email":"choplin.choplin@gmail.com"}],"homepage":"https://github.com/choplin/jira-cli-mcp#readme","bugs":{"url":"https://github.com/choplin/jira-cli-mcp/issues"},"bin":{"jira-cli-mcp":"dist/index.js"},"dist":{"shasum":"db8b97793971a82f9e4dee9b5940e1167fb32f53","tarball":"https://registry.npmjs.org/@choplin/jira-cli-mcp/-/jira-cli-mcp-0.3.0.tgz","fileCount":4,"integrity":"sha512-5JUrdKyDGjEc9mdeoHS3IQlefe6JyT3vqNo8BFRhwviiXj/Ioo+gRFgsCT45dFxFGRNHYu0MLPG7TV6FoQmC6Q==","signatures":[{"sig":"MEQCIH1XQPKz5Z5/zT3y0JzLzn7/+nvnPwbGb9ZG/CD/mlwQAiBS2TJN0JxJzjgYkRPi4u8N6scCcOw+6o9y14VHTn5GHg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":137992},"main":"dist/index.js","type":"module","module":"dist/index.js","engines":{"node":">=18.0.0"},"gitHead":"4ab3b62edd7e7a7968c0331cc0acd843d42457e3","scripts":{"ci":"bun run check && bun run typecheck && bun test && bun run build","dev":"bun --watch run src/index.ts","lint":"biome lint src/","test":"bun test tests/","build":"rm -rf dist && bun build --target=node --banner=$'#!/usr/bin/env node\\n' --outdir=dist --sourcemap src/index.ts","check":"biome check src/","start":"bun run src/index.ts","format":"biome format --write src/","lint:md":"markdownlint-cli2 '**/*.md' '#node_modules'","prepare":"lefthook install","lint:fix":"biome lint --write src/","build:tsc":"rm -rf dist && tsc -p tsconfig.build.json","check:fix":"biome check --write src/","typecheck":"tsc --noEmit","build:prod":"rm -rf dist && bun build --target=node --banner=$'#!/usr/bin/env node\\n' --outdir=dist --minify --sourcemap=none src/index.ts","lint:md:fix":"markdownlint-cli2 --fix '**/*.md' '#node_modules'","build:binaries":"bun run build:binary:darwin-arm64 && bun run build:binary:darwin-x64 && bun run build:binary:linux-x64 && bun run build:binary:linux-arm64","test:integration":"INTEGRATION_TEST=true bun test tests/integration/","build:binary:linux-x64":"bun build --compile --target=bun-linux-x64 --minify --sourcemap=none --outfile=jira-cli-mcp-linux-x64 src/index.ts","build:binary:darwin-x64":"bun build --compile --target=bun-darwin-x64 --minify --sourcemap=none --outfile=jira-cli-mcp-darwin-x64 src/index.ts","build:binary:linux-arm64":"bun build --compile --target=bun-linux-arm64 --minify --sourcemap=none --outfile=jira-cli-mcp-linux-arm64 src/index.ts","build:binary:darwin-arm64":"bun build --compile --target=bun-darwin-arm64 --minify --sourcemap=none --outfile=jira-cli-mcp-darwin-arm64 src/index.ts"},"_npmUser":{"name":"choplin","email":"choplin.choplin@gmail.com"},"repository":{"url":"git+https://github.com/choplin/jira-cli-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server that wraps jira-cli for AI assistants","directories":{},"_nodeVersion":"20.19.1","dependencies":{"zod":"^3.25.49","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"lefthook":"^1.11.13","@types/bun":"^1.2.15","@types/node":"^22.15.29","@biomejs/biome":"^1.9.4","@commitlint/cli":"^19.8.1","markdownlint-cli2":"^0.18.1","@commitlint/config-conventional":"^19.8.1"},"peerDependencies":{"typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/jira-cli-mcp_0.3.0_1749136467419_0.08589409710878027","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@choplin/jira-cli-mcp","version":"0.4.0","description":"MCP server that wraps jira-cli for AI assistants","license":"MIT","author":{"name":"Akihiro Okuno"},"repository":{"type":"git","url":"git+https://github.com/choplin/jira-cli-mcp.git"},"homepage":"https://github.com/choplin/jira-cli-mcp#readme","bugs":{"url":"https://github.com/choplin/jira-cli-mcp/issues"},"keywords":["mcp","jira","jira-cli","modelcontextprotocol","ai","claude"],"main":"dist/index.js","module":"dist/index.js","type":"module","bin":{"jira-cli-mcp":"dist/index.js"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"scripts":{"start":"bun run src/index.ts","dev":"bun --watch run src/index.ts","build":"rm -rf dist && bun build --target=node --banner=$'#!/usr/bin/env node\\n' --outdir=dist --sourcemap src/index.ts","build:prod":"rm -rf dist && bun build --target=node --banner=$'#!/usr/bin/env node\\n' --outdir=dist --minify --sourcemap=none src/index.ts","build:tsc":"rm -rf dist && tsc -p tsconfig.build.json","build:binary:darwin-arm64":"bun build --compile --target=bun-darwin-arm64 --minify --sourcemap=none --outfile=jira-cli-mcp-darwin-arm64 src/index.ts","build:binary:darwin-x64":"bun build --compile --target=bun-darwin-x64 --minify --sourcemap=none --outfile=jira-cli-mcp-darwin-x64 src/index.ts","build:binary:linux-x64":"bun build --compile --target=bun-linux-x64 --minify --sourcemap=none --outfile=jira-cli-mcp-linux-x64 src/index.ts","build:binary:linux-arm64":"bun build --compile --target=bun-linux-arm64 --minify --sourcemap=none --outfile=jira-cli-mcp-linux-arm64 src/index.ts","build:binaries":"bun run build:binary:darwin-arm64 && bun run build:binary:darwin-x64 && bun run build:binary:linux-x64 && bun run build:binary:linux-arm64","test":"bun test tests/","test:integration":"INTEGRATION_TEST=true bun test tests/integration/","typecheck":"tsc --noEmit","lint":"biome lint src/","lint:fix":"biome lint --write src/","lint:md":"markdownlint-cli2 '**/*.md' '#node_modules'","lint:md:fix":"markdownlint-cli2 --fix '**/*.md' '#node_modules'","format":"biome format --write src/","check":"biome check src/","check:fix":"biome check --write src/","ci":"bun run check && bun run typecheck && bun test && bun run build","prepare":"lefthook install"},"devDependencies":{"@biomejs/biome":"^1.9.4","@commitlint/cli":"^19.8.1","@commitlint/config-conventional":"^19.8.1","@types/bun":"^1.2.15","@types/node":"^22.15.29","lefthook":"^1.11.13","markdownlint-cli2":"^0.18.1"},"peerDependencies":{"typescript":"^5.8.3"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.25.49"},"_id":"@choplin/jira-cli-mcp@0.4.0","gitHead":"5e57471410f451a6fe3e733f360e043aefa19922","_nodeVersion":"20.19.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-ltUN9yyDpvDsBzj/2ZcC7yDv+7Wjb1oy7FwiLr5IZA0E6p262eBoX8ywudsOBV6LruYy9l6Hjb0G0Iuxu30sqQ==","shasum":"b48ca7903fa6e19d4286a906cc7fdb3734f6fe68","tarball":"https://registry.npmjs.org/@choplin/jira-cli-mcp/-/jira-cli-mcp-0.4.0.tgz","fileCount":4,"unpackedSize":140017,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCf5d/vuhIqccYISpLG0a1s0Qbbv6n9Vi4GmULmbaut4AIgWxB8e8AotiFuRQC71mxIAgUidQAEzJnodk8ECNPtY8o="}]},"_npmUser":{"name":"choplin","email":"choplin.choplin@gmail.com"},"directories":{},"maintainers":[{"name":"choplin","email":"choplin.choplin@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jira-cli-mcp_0.4.0_1749400930274_0.6606892540516933"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-05T12:33:29.598Z","modified":"2025-06-08T16:42:10.633Z","0.2.0":"2025-06-05T12:33:29.877Z","0.2.1":"2025-06-05T13:47:24.094Z","0.3.0":"2025-06-05T15:14:27.612Z","0.4.0":"2025-06-08T16:42:10.467Z"},"bugs":{"url":"https://github.com/choplin/jira-cli-mcp/issues"},"author":{"name":"Akihiro Okuno"},"license":"MIT","homepage":"https://github.com/choplin/jira-cli-mcp#readme","keywords":["mcp","jira","jira-cli","modelcontextprotocol","ai","claude"],"repository":{"type":"git","url":"git+https://github.com/choplin/jira-cli-mcp.git"},"description":"MCP server that wraps jira-cli for AI assistants","maintainers":[{"name":"choplin","email":"choplin.choplin@gmail.com"}],"readme":"# Jira CLI MCP Server\n\n[![CI](https://github.com/choplin/jira-cli-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/choplin/jira-cli-mcp/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-1.0-green.svg)](https://modelcontextprotocol.io)\n\nMCP (Model Context Protocol) server that wraps the `jira-cli` command-line tool to enable AI assistants to interact\nwith Jira.\n\n## Why jira-cli-mcp?\n\nIf you're looking for a Jira MCP server, here's what makes jira-cli-mcp unique:\n\n- **🚀 Leverage Existing Tools** - Works seamlessly with your existing jira-cli setup and authentication\n- **🔒 Security-First** - No API tokens in config files; authentication handled by jira-cli  \n- **🪶 Lightweight** - Just a Bun process, no Docker or containers required\n\n### When to use mcp-atlassian instead?\n\nChoose [mcp-atlassian](https://github.com/sooperset/mcp-atlassian) if you:\n\n- Need **Confluence** support (we're Jira-only)\n- Prefer **Docker** deployment\n- Want a **self-contained** solution without CLI dependencies\n- Need **direct API** integration rather than CLI wrapping\n\n## Features\n\n- **create_ticket** - Create new Jira tickets with customizable fields\n- **list_tickets** - Search and list Jira tickets using JQL queries\n- **get_ticket** - Get detailed ticket information including comments\n- **update_ticket_description** - Update ticket descriptions with rich text formatting\n- **add_comment** - Add comments to tickets with Markdown support\n- **assign_to_me** - Assign tickets to the current user\n- **move_ticket** - Move tickets between different statuses\n- **open_ticket_in_browser** - Open a Jira ticket in the default web browser\n\n## Quick Start\n\n1. Install and configure [jira-cli](https://github.com/ankitpokhrel/jira-cli) ([Installation guide](https://github.com/ankitpokhrel/jira-cli/wiki/Installation)):\n\n   ```bash\n   # Install jira-cli (macOS)\n   brew install ankitpokhrel/jira-cli/jira-cli\n   \n   # Configure jira-cli with your Jira instance\n   jira init\n   ```\n\n2. Install jira-cli-mcp:\n\n   ```bash\n   brew tap choplin/jira-cli-mcp\n   brew install jira-cli-mcp\n   ```\n\n3. Add to Claude Desktop config (see [Setup](#setup-for-claude-desktop) below)\n\n## Prerequisites\n\n- [jira-cli](https://github.com/ankitpokhrel/jira-cli) installed and authenticated\n- [Bun](https://bun.sh) runtime (only needed for development or if installing from source)\n\n## Installation\n\n### Option 1: Install via Homebrew (macOS/Linux)\n\n```bash\nbrew tap choplin/jira-cli-mcp\nbrew install jira-cli-mcp\n```\n\n### Option 2: Install via npm\n\n```bash\n# Install globally with npm\nnpm install -g @choplin/jira-cli-mcp\n\n# Or with Bun\nbun install -g @choplin/jira-cli-mcp\n```\n\n### Option 3: Download Binary\n\nDownload the pre-compiled binary for your platform from the [releases page](https://github.com/choplin/jira-cli-mcp/releases):\n\n- macOS (Apple Silicon): `jira-cli-mcp-darwin-arm64.tar.gz`\n- macOS (Intel): `jira-cli-mcp-darwin-x64.tar.gz`\n- Linux (x64): `jira-cli-mcp-linux-x64.tar.gz`\n- Linux (ARM64): `jira-cli-mcp-linux-arm64.tar.gz`\n\n```bash\n# Example for macOS (Apple Silicon)\ntar -xzf jira-cli-mcp-darwin-arm64.tar.gz\nchmod +x jira-cli-mcp-darwin-arm64\nsudo mv jira-cli-mcp-darwin-arm64 /usr/local/bin/jira-cli-mcp\n```\n\n### Option 4: Build from Source\n\n```bash\ngit clone https://github.com/choplin/jira-cli-mcp.git\ncd jira-cli-mcp\nbun install\nbun run build:prod\n```\n\n## Setup for Claude Desktop\n\n### Option 1: Using Homebrew Installation (Recommended)\n\nIf you installed via Homebrew (as shown in Quick Start), add to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira-cli\": {\n      \"command\": \"jira-cli-mcp\"\n    }\n  }\n}\n```\n\n### Option 2: Using npm Package\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira-cli\": {\n      \"command\": \"npx\",\n      \"args\": [\"@choplin/jira-cli-mcp\"]\n    }\n  }\n}\n```\n\nOr if installed globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira-cli\": {\n      \"command\": \"jira-cli-mcp\"\n    }\n  }\n}\n```\n\n### Option 3: Using Pre-compiled Binary (No Dependencies)\n\n1. Download the binary for your platform from [releases](https://github.com/choplin/jira-cli-mcp/releases)\n2. Extract and move to your PATH:\n\n```bash\ntar -xzf jira-cli-mcp-darwin-arm64.tar.gz\nsudo mv jira-cli-mcp-darwin-arm64 /usr/local/bin/jira-cli-mcp\n```\n\n1. Add to config:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira-cli\": {\n      \"command\": \"jira-cli-mcp\"\n    }\n  }\n}\n```\n\n### Option 4: Build from Source\n\n1. Clone and run directly:\n\n```bash\ngit clone https://github.com/choplin/jira-cli-mcp.git\ncd jira-cli-mcp\nbun install\n```\n\n1. Add to config:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira-cli\": {\n      \"command\": \"bun\",\n      \"args\": [\"run\", \"/path/to/jira-cli-mcp/src/index.ts\"]\n    }\n  }\n}\n```\n\n### Configuration Location\n\nThe config file is typically located at:\n\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Linux: `~/.config/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n### Verification\n\nAfter setup, restart Claude Desktop and check if the MCP server is loaded by asking Claude about available Jira tools.\n\n## Setup for Other AI Assistants\n\n### Claude Code\n\nClaude Code has built-in support for MCP servers. To use jira-cli-mcp in your project:\n\n1. First install jira-cli-mcp using one of the methods in the [Installation](#installation) section\n\n2. Create a `.claude/mcp.json` file in your project root:\n\n```json\n{\n  \"servers\": {\n    \"jira-cli\": {\n      \"command\": \"jira-cli-mcp\"\n    }\n  }\n}\n```\n\n1. Restart Claude Code and the MCP server will be automatically loaded\n\nYou can then use Jira commands directly in your conversation, such as:\n\n- \"List my open Jira tickets\"\n- \"Show me details for PROJ-123\"\n- \"Add a comment to PROJ-456\"\n\n### GitHub Copilot (VS Code)\n\nGitHub Copilot supports MCP servers in Visual Studio Code (version 1.99+):\n\n1. First install jira-cli-mcp using one of the methods in the [Installation](#installation) section\n\n2. Create `.vscode/mcp.json` in your repository:\n\n```json\n{\n  \"servers\": {\n    \"jira-cli\": {\n      \"command\": \"jira-cli-mcp\"\n    }\n  }\n}\n```\n\n1. Open the `.vscode/mcp.json` file in VS Code and click the **[Start]** button to activate the server\n\n2. In Copilot Chat:\n   - Open Copilot Chat panel\n   - Select \"Agent\" from the popup menu\n   - Click the tools icon to see available MCP servers\n\n**Note**: MCP support in GitHub Copilot is currently in public preview.\n\n## Development\n\n### Running Tests\n\n```bash\n# Run unit tests only\nbun test\n\n# Run all tests including integration tests\nbun run test:integration\n\n# Run integration tests with a specific test ticket\nJIRA_CLI_MCP_TEST_TICKET=PROJ-123 bun run test:integration\n```\n\n### Environment Variables\n\n- `JIRA_CLI_PATH` - Custom path to jira-cli executable (default: \"jira\")\n\n#### Development Environment Variables\n\n- `JIRA_CLI_MCP_TEST_TICKET` - Ticket key for integration tests (required for non-listing integration tests)\n- `INTEGRATION_TEST=true` - Enable integration tests\n\n### Type Checking\n\n```bash\nbun run typecheck\n```\n\n### Linting and Formatting\n\n```bash\nbun run lint\nbun run format\n```\n\n## Architecture\n\n- `src/tools/` - MCP tool implementations\n- `src/utils/` - Shared utilities and types\n- `tests/` - Unit tests with mocked jira-cli\n- `tests/integration/` - Integration tests with real jira-cli\n\n## Notes\n\n- The server uses Atlassian Document Format (ADF) for rich text handling\n- Markdown input is automatically converted to ADF by jira-cli\n- All integration tests require proper jira-cli authentication\n\n## Troubleshooting\n\n### Common Issues\n\n1. **\"jira-cli not found\" error**\n   - Ensure jira-cli is installed: `which jira`\n   - If using a custom path, set `JIRA_CLI_PATH` environment variable\n\n2. **Authentication errors**\n   - Run `jira me` to verify authentication\n   - Re-authenticate with `jira init` if needed\n\n3. **MCP server not showing in Claude Desktop**\n   - Verify the config file path is correct\n   - Ensure the path in config uses absolute paths, not relative\n   - Restart Claude Desktop after config changes\n\n4. **Permission errors on macOS**\n   - Grant terminal/Claude Desktop full disk access in System Preferences\n   - Ensure jira-cli has necessary permissions\n\n### Debug Mode\n\nTo see detailed logs, you can run the server manually:\n\n```bash\ncd /path/to/jira-cli-mcp\nbun run src/index.ts\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","readmeFilename":"README.md"}