{"_id":"@bugzy-ai/jira-mcp-server","_rev":"4-be1fa4da97348556aa482fad6e87743c","name":"@bugzy-ai/jira-mcp-server","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@bugzy-ai/jira-mcp-server","version":"0.1.0","keywords":["mcp","jira","jira-server","model-context-protocol","ai","claude"],"author":{"name":"Bugzy AI"},"license":"MIT","_id":"@bugzy-ai/jira-mcp-server@0.1.0","maintainers":[{"name":"mslavov","email":"milko.slavov@gmail.com"}],"homepage":"https://github.com/bugzy-ai/jira-mcp-server#readme","bugs":{"url":"https://github.com/bugzy-ai/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"1b3af13597d23ef2c1419ab25b980970f8d9c222","tarball":"https://registry.npmjs.org/@bugzy-ai/jira-mcp-server/-/jira-mcp-server-0.1.0.tgz","fileCount":23,"integrity":"sha512-RBf/ZZcSqKKa4Xh7WCanUCIyAFEofjLUmjPk/WLR75ND8CDxMIS+S2+IBV4zeWz0sQC94WSDvEFa1f4bYYUj0A==","signatures":[{"sig":"MEQCIAa+iT5hOZ8I9I7LtiU0DMrpXORbGSx2c48nhWxxT/vsAiBPU9zzLlWqfYQiaQ1+OFMzOYhdE8fLfieipZpv0qW8Fw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55098},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"8a0c29724a1361c3d252309fb970f057ffd0d91e","scripts":{"dev":"npx @modelcontextprotocol/inspector dist/index.js","build":"tsc --project tsconfig.build.json","clean":"shx rm -rf dist","setup":"./scripts/setup-local-jira.sh","start":"node dist/index.js","build:watch":"tsc --project tsconfig.build.json --watch","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"mslavov","email":"milko.slavov@gmail.com"},"repository":{"url":"git+https://github.com/bugzy-ai/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.0","description":"MCP server for Jira Server (on-premise) integration","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.22.4","dotenv":"^16.4.7","zod-to-json-schema":"^3.22.4","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.3.2","@types/node":"^20.10.3"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_0.1.0_1764049779614_0.9792918047363968","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@bugzy-ai/jira-mcp-server","version":"0.1.1","keywords":["mcp","jira","jira-server","model-context-protocol","ai","claude"],"author":{"name":"Bugzy AI"},"license":"MIT","_id":"@bugzy-ai/jira-mcp-server@0.1.1","maintainers":[{"name":"mslavov","email":"milko.slavov@gmail.com"}],"homepage":"https://github.com/bugzy-ai/jira-mcp-server#readme","bugs":{"url":"https://github.com/bugzy-ai/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"ae5a8d79c4618787293be1ae2d61b3b53e3a649b","tarball":"https://registry.npmjs.org/@bugzy-ai/jira-mcp-server/-/jira-mcp-server-0.1.1.tgz","fileCount":23,"integrity":"sha512-Z88VllJbSjb1GsSDHpwiGnEYNg0StefSgEV9s4lmeyshNs7p68ZJY9lx5L8MHaeACTGBzDCqKiFcwO+05RTs1g==","signatures":[{"sig":"MEUCIGeJd6cRw/4TyQQEsjIG7BCJJSQkC/xFhETopZTCwyanAiEAu0OhnD2Hk5VK9Ng74BWdB373t0f3rHkY6fu36RbpVQs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55098},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"8a0c29724a1361c3d252309fb970f057ffd0d91e","scripts":{"dev":"npx @modelcontextprotocol/inspector dist/index.js","build":"tsc --project tsconfig.build.json","clean":"shx rm -rf dist","setup":"./scripts/setup-local-jira.sh","start":"node dist/index.js","build:watch":"tsc --project tsconfig.build.json --watch","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"mslavov","email":"milko.slavov@gmail.com"},"repository":{"url":"git+https://github.com/bugzy-ai/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.0","description":"MCP server for Jira Server (on-premise) integration","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.22.4","dotenv":"^16.4.7","zod-to-json-schema":"^3.22.4","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.3.2","@types/node":"^20.10.3"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_0.1.1_1764075629417_0.5456601411942601","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@bugzy-ai/jira-mcp-server","version":"0.1.2","keywords":["mcp","jira","jira-server","model-context-protocol","ai","claude"],"author":{"name":"Bugzy AI"},"license":"MIT","_id":"@bugzy-ai/jira-mcp-server@0.1.2","maintainers":[{"name":"mslavov","email":"milko.slavov@gmail.com"}],"homepage":"https://github.com/bugzy-ai/jira-mcp-server#readme","bugs":{"url":"https://github.com/bugzy-ai/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"567b08dd6a8918b77fe24f1bd70f89608838434a","tarball":"https://registry.npmjs.org/@bugzy-ai/jira-mcp-server/-/jira-mcp-server-0.1.2.tgz","fileCount":23,"integrity":"sha512-qJyuPXR6ixDrfpAEsnydlBQt1IwiqTXS/qI0+OF+R6DQOPbeIyxZexepnahFCbP4hr5nmrr9t/18QImuMo12EA==","signatures":[{"sig":"MEUCIQCqKspIO3hYn7XC2mENLtWtJyQUT3YBx8b2OAfsWb3kVwIgGj1rzruqHc2B4s64nl3W5JpmCma1aCCB/pBjN1AGYBk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56834},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"1f8b6d4b14f2136aeff6499b1ebe00e1d236ea99","scripts":{"dev":"npx @modelcontextprotocol/inspector dist/index.js","build":"tsc --project tsconfig.build.json","clean":"shx rm -rf dist","setup":"./scripts/setup-local-jira.sh","start":"node dist/index.js","build:watch":"tsc --project tsconfig.build.json --watch","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"mslavov","email":"milko.slavov@gmail.com"},"repository":{"url":"git+https://github.com/bugzy-ai/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.0","description":"MCP server for Jira Server (on-premise) integration","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.22.4","dotenv":"^16.4.7","zod-to-json-schema":"^3.22.4","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.3.2","@types/node":"^20.10.3"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_0.1.2_1764082025755_0.8642685498759497","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-11-25T05:49:39.540Z","modified":"2026-01-16T08:26:55.544Z","0.1.0":"2025-11-25T05:49:39.823Z","0.1.1":"2025-11-25T13:00:29.606Z","0.1.2":"2025-11-25T14:47:05.941Z"},"bugs":{"url":"https://github.com/bugzy-ai/jira-mcp-server/issues"},"author":{"name":"Bugzy AI"},"license":"MIT","homepage":"https://github.com/bugzy-ai/jira-mcp-server#readme","keywords":["mcp","jira","jira-server","model-context-protocol","ai","claude"],"repository":{"url":"git+https://github.com/bugzy-ai/jira-mcp-server.git","type":"git"},"description":"MCP server for Jira Server (on-premise) integration","maintainers":[{"email":"milko.slavov@gmail.com","name":"mslavov"},{"email":"dimitar2306@gmail.com","name":"dimitar-panayotov"}],"readme":"# @bugzy-ai/jira-mcp-server\n\nMCP (Model Context Protocol) server for Jira Server (on-premise) integration. Enables AI assistants like Claude to interact with Jira Server deployments via standardized tools.\n\n## Features\n\n- **jira_search_issues** - Search issues using JQL (Jira Query Language)\n- **jira_get_issue** - Get detailed information about a specific issue\n- **jira_create_issue** - Create new issues in any project\n- **jira_add_comment** - Add comments to existing issues\n\n## Requirements\n\n- Node.js 20.0.0 or higher\n- Jira Server/Data Center 8.14+ (for PAT authentication) or any version (for basic auth)\n\n## Installation\n\n```bash\nnpm install @bugzy-ai/jira-mcp-server\n```\n\nOr run directly with npx:\n\n```bash\nnpx @bugzy-ai/jira-mcp-server\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Description | Required |\n|----------|-------------|----------|\n| `JIRA_BASE_URL` | Your Jira Server URL (e.g., `https://jira.yourcompany.com`) | Yes |\n| `JIRA_AUTH_TYPE` | Authentication type: `pat` or `basic` | No (default: `pat`) |\n| `JIRA_PAT` | Personal Access Token (when using PAT auth) | When `JIRA_AUTH_TYPE=pat` |\n| `JIRA_USERNAME` | Username (when using basic auth) | When `JIRA_AUTH_TYPE=basic` |\n| `JIRA_PASSWORD` | Password (when using basic auth) | When `JIRA_AUTH_TYPE=basic` |\n\n### Creating a Personal Access Token (PAT)\n\n1. Log in to your Jira Server instance\n2. Click your profile picture > **Profile**\n3. Click **Personal Access Tokens** in the left sidebar\n4. Click **Create token**\n5. Give it a name and optionally set an expiry date\n6. Copy the generated token\n\n## Claude Desktop Integration\n\nAdd the following to your Claude Desktop configuration file:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"npx\",\n      \"args\": [\"@bugzy-ai/jira-mcp-server\"],\n      \"env\": {\n        \"JIRA_BASE_URL\": \"https://jira.yourcompany.com\",\n        \"JIRA_AUTH_TYPE\": \"pat\",\n        \"JIRA_PAT\": \"your-personal-access-token\"\n      }\n    }\n  }\n}\n```\n\nOr if installed locally:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/jira-mcp-server/dist/index.js\"],\n      \"env\": {\n        \"JIRA_BASE_URL\": \"https://jira.yourcompany.com\",\n        \"JIRA_AUTH_TYPE\": \"pat\",\n        \"JIRA_PAT\": \"your-personal-access-token\"\n      }\n    }\n  }\n}\n```\n\n## Usage Examples\n\nOnce configured, you can ask Claude to:\n\n- \"Search for open bugs in the TEST project\"\n- \"Get details about issue TEST-123\"\n- \"Create a new bug in project TEST with summary 'Login button not working'\"\n- \"Add a comment to TEST-123 saying the issue has been reproduced\"\n\n## Tool Reference\n\n### jira_search_issues\n\nSearch for issues using JQL.\n\n**Parameters:**\n- `jql` (required): JQL query string\n- `maxResults` (optional): Maximum results (1-100, default: 50)\n- `fields` (optional): Fields to include in response\n\n**Example:**\n```\njql: \"project = TEST AND status = Open ORDER BY created DESC\"\nmaxResults: 20\n```\n\n### jira_get_issue\n\nGet detailed information about a specific issue.\n\n**Parameters:**\n- `issueKey` (required): Issue key (e.g., \"TEST-123\")\n- `fields` (optional): Specific fields to retrieve\n- `expand` (optional): Additional data to expand (e.g., \"changelog\", \"transitions\")\n\n### jira_create_issue\n\nCreate a new issue.\n\n**Parameters:**\n- `projectKey` (required): Project key (e.g., \"TEST\")\n- `summary` (required): Issue summary/title\n- `issueType` (required): Issue type (e.g., \"Bug\", \"Task\", \"Story\")\n- `description` (optional): Issue description\n- `priority` (optional): Priority name (e.g., \"High\", \"Medium\")\n- `assignee` (optional): Username to assign to\n- `labels` (optional): Array of labels\n- `components` (optional): Array of component names\n\n### jira_add_comment\n\nAdd a comment to an existing issue.\n\n**Parameters:**\n- `issueKey` (required): Issue key (e.g., \"TEST-123\")\n- `body` (required): Comment text (supports Jira wiki markup)\n- `visibility` (optional): Visibility restriction (group or role)\n\n## Development\n\n### Prerequisites\n\n- Node.js 20+\n- Docker (for local Jira instance)\n- 6GB+ RAM available for Docker\n\n### Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/bugzy-ai/jira-mcp-server.git\ncd jira-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Setup local Jira (Docker)\nnpm run setup\n```\n\n### Local Jira Setup\n\nThe setup script will:\n1. Start a Jira Docker container\n2. Wait for Jira to be ready (~3-5 minutes on first boot)\n3. Guide you through manual setup (license + admin user)\n4. Create a TEST project for development\n5. Generate a `.env` file with local credentials\n\n**First run requires manual steps:**\n1. Open http://localhost:8080 in your browser\n2. Complete the setup wizard\n3. Get a [free evaluation license](https://my.atlassian.com/license/evaluation) or [timebomb license](https://developer.atlassian.com/platform/marketplace/timebomb-licenses-for-testing-server-apps/)\n4. Create admin user (recommended: `admin`/`admin`)\n5. Run `npm run setup` again to create test project\n\n### Testing\n\n**With MCP Inspector (debug individual tools):**\n```bash\nnpm run dev\n# Opens browser at http://localhost:6274\n```\n\n**With Claude Code (test in conversation):**\n1. The project includes a `.mcp.json` that configures the local server\n2. Restart Claude Code to pick up the config\n3. Try: \"Search for issues in the TEST project\"\n\n### Available Scripts\n\n| Script | Description |\n|--------|-------------|\n| `npm run build` | Build TypeScript to dist/ |\n| `npm run build:watch` | Build with watch mode |\n| `npm run dev` | Run MCP Inspector |\n| `npm run setup` | Setup local Jira Docker |\n| `npm start` | Run the MCP server |\n| `npm run clean` | Remove dist/ |\n\n### Docker Commands\n\n```bash\n# View Jira logs\ndocker logs jira-mcp-test\n\n# Stop Jira\ndocker stop jira-mcp-test\n\n# Start Jira\ndocker start jira-mcp-test\n\n# Remove container (loses data)\ndocker rm -f jira-mcp-test\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}