{"_id":"@abhaydeshmukh/jira-mcp","name":"@abhaydeshmukh/jira-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@abhaydeshmukh/jira-mcp","version":"1.0.0","description":"Model Context Protocol (MCP) server for Jira integration with AI assistants","main":"index.js","type":"module","bin":{"jira-mcp-server":"bin/cli.js","mcp-jira":"bin/cli.js"},"scripts":{"start":"node index.js","dev":"node --watch index.js","setup":"node bin/setup.js","test":"node test_comprehensive.js"},"dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","jira-client":"^8.2.2","dotenv":"^16.3.1"},"engines":{"node":">=18.0.0"},"keywords":["mcp","jira","ai","context","model-context-protocol","atlassian","cursor","claude","assistant"],"author":{"name":"MCP Servers Community"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/your-org/mcp-servers.git","directory":"packages/jira"},"bugs":{"url":"https://github.com/your-org/mcp-servers/issues"},"homepage":"https://github.com/your-org/mcp-servers/tree/main/packages/jira#readme","_id":"@abhaydeshmukh/jira-mcp@1.0.0","_nodeVersion":"23.11.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-4oixQuuhuA08hajV//7uiqdPtPv5abRMbC6W1iqSDw7bCoJx+6j6dgJHP7we8QqH7SPvNNaDd6CnoUZIVYkoFw==","shasum":"5c38ebef1d7f4f950173cdaae2e01b42d35b9b02","tarball":"https://registry.npmjs.org/@abhaydeshmukh/jira-mcp/-/jira-mcp-1.0.0.tgz","fileCount":13,"unpackedSize":66940,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBCcwfE86RzjCUXlgX72JpnNtR+CTQARGhwnTUu762jGAiBKLgUYHvy+2RT8X2aQozrtP2fwnd7g1ro/ZSruw8kXuQ=="}]},"_npmUser":{"name":"abhaydeshmukh","email":"contactabhaydeshmukh@gmail.com","actor":{"name":"abhaydeshmukh","email":"contactabhaydeshmukh@gmail.com","type":"user"}},"directories":{},"maintainers":[{"name":"abhaydeshmukh","email":"contactabhaydeshmukh@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jira-mcp_1.0.0_1751955620884_0.929035308134279"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-08T06:20:20.819Z","1.0.0":"2025-07-08T06:20:21.139Z","modified":"2025-07-08T06:20:21.389Z"},"maintainers":[{"name":"abhaydeshmukh","email":"contactabhaydeshmukh@gmail.com"}],"description":"Model Context Protocol (MCP) server for Jira integration with AI assistants","homepage":"https://github.com/your-org/mcp-servers/tree/main/packages/jira#readme","keywords":["mcp","jira","ai","context","model-context-protocol","atlassian","cursor","claude","assistant"],"repository":{"type":"git","url":"git+https://github.com/your-org/mcp-servers.git","directory":"packages/jira"},"author":{"name":"MCP Servers Community"},"bugs":{"url":"https://github.com/your-org/mcp-servers/issues"},"license":"MIT","readme":"# @mcp-servers/jira\n\nA Model Context Protocol (MCP) server for Jira integration with AI assistants like Claude, Cursor, and other MCP-compatible tools.\n\n## Features\n\n- 🎫 **Issue Management**: List, view, create, update, and transition Jira issues\n- 🔍 **Advanced Search**: Search issues using JQL (Jira Query Language)\n- 👥 **User Management**: Assign issues, get user information\n- 💬 **Comments**: Add and retrieve issue comments\n- 📊 **Project Information**: Access project details and metadata\n- 🔄 **Streaming Support**: Handle large result sets efficiently\n- ⚙️ **Flexible Configuration**: Comprehensive environment variable support\n\n## Installation\n\n### Global Installation (Recommended)\n\n```bash\nnpm install -g @mcp-servers/jira\n```\n\n### Local Installation\n\n```bash\nnpm install @mcp-servers/jira\n```\n\n## Quick Setup\n\nRun the interactive setup to configure your Jira connection:\n\n```bash\nnpx @mcp-servers/jira setup\n```\n\nThis will:\n1. Guide you through entering your Jira credentials\n2. Create a `.env` file with your configuration\n3. Generate MCP client configuration\n4. Provide setup instructions for your MCP client\n\n## Manual Configuration\n\n### Environment Variables\n\nCreate a `.env` file or set these environment variables:\n\n```bash\n# Required\nJIRA_HOST=your-company.atlassian.net\nJIRA_USERNAME=your.email@company.com\nJIRA_API_TOKEN=your_api_token_here\n\n# Optional (with defaults)\nJIRA_PROTOCOL=https\nJIRA_API_VERSION=3\nJIRA_REQUEST_TIMEOUT=30000\nJIRA_MAX_RESULTS=50\nJIRA_DEFAULT_PROJECT=PROJECT_KEY  # Optional default project\n```\n\n### Getting a Jira API Token\n\n1. Go to [Atlassian Account Settings](https://id.atlassian.com/manage-profile/security/api-tokens)\n2. Click \"Create API token\"\n3. Give it a label (e.g., \"MCP Server\")\n4. Copy the generated token\n\n## MCP Client Configuration\n\n### Cursor\n\nAdd to `~/.config/cursor/mcp_servers.json`:\n\n```json\n{\n  \"jira\": {\n    \"command\": \"npx\",\n    \"args\": [\"@mcp-servers/jira\"],\n    \"env\": {\n      \"JIRA_HOST\": \"your-company.atlassian.net\",\n      \"JIRA_USERNAME\": \"your.email@company.com\",\n      \"JIRA_API_TOKEN\": \"your_api_token_here\"\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nAdd to your Claude Desktop MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"npx\",\n      \"args\": [\"@mcp-servers/jira\"],\n      \"env\": {\n        \"JIRA_HOST\": \"your-company.atlassian.net\",\n        \"JIRA_USERNAME\": \"your.email@company.com\",\n        \"JIRA_API_TOKEN\": \"your_api_token_here\"\n      }\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\nThe server can be started directly:\n\n```bash\nnpx @mcp-servers/jira\n# or if installed globally:\njira-mcp-server\n```\n\n## Available Tools\n\nThe MCP server provides these tools to AI assistants:\n\n### Core Tools\n- `mcp_JIRA_list_projects` - List available projects\n- `mcp_JIRA_get_project` - Get project details\n- `mcp_JIRA_list_issues` - List issues with filtering\n- `mcp_JIRA_get_issue` - Get detailed issue information\n- `mcp_JIRA_search_issues` - Search using JQL\n\n### Issue Management\n- `mcp_JIRA_create_issue` - Create new issues\n- `mcp_JIRA_update_issue` - Update existing issues\n- `mcp_JIRA_transition_issue` - Change issue status\n- `mcp_JIRA_get_issue_transitions` - Get available transitions\n- `mcp_JIRA_assign_issue` - Assign issues to users\n\n### Comments & Collaboration\n- `mcp_JIRA_add_comment` - Add comments to issues\n- `mcp_JIRA_get_comments` - Retrieve issue comments\n- `mcp_JIRA_get_user` - Get user information\n\n## Usage Examples\n\nOnce configured with an MCP client, you can ask your AI assistant:\n\n- \"Show me my assigned Jira tickets\"\n- \"Create a new bug ticket for the login issue\"\n- \"What's the status of PROJ-123?\"\n- \"Search for all high priority issues in the mobile project\"\n- \"Add a comment to PROJ-456 about the fix being deployed\"\n- \"Move PROJ-789 to 'In Progress'\"\n\n## Configuration Options\n\n### Default Project\n\nSet `JIRA_DEFAULT_PROJECT` to avoid specifying project_key in every request:\n\n```bash\nJIRA_DEFAULT_PROJECT=MYPROJ\n```\n\n### Performance Tuning\n\nAdjust these for your needs:\n\n```bash\nJIRA_REQUEST_TIMEOUT=60000  # 60 seconds\nJIRA_MAX_RESULTS=100        # Return more results per query\n```\n\n### SSL Configuration\n\nFor on-premise Jira with custom certificates:\n\n```bash\nJIRA_STRICT_SSL=false\n```\n\n## Development\n\n### Local Development\n\n1. Clone the repository\n2. Install dependencies: `npm install`\n3. Create `.env` file with your configuration\n4. Start the server: `npm start`\n\n### Testing\n\n```bash\nnpm test\n```\n\n## Troubleshooting\n\n### Common Issues\n\n**Authentication Errors**\n- Verify your API token is correct and not expired\n- Ensure your username/email is correct\n- Check that your account has necessary permissions\n\n**Connection Errors**\n- Verify the JIRA_HOST is correct (without https:// prefix)\n- Check your network connection\n- For on-premise Jira, verify SSL settings\n\n**Permission Errors**\n- Ensure your Jira account has permissions for the projects you're trying to access\n- Some operations require specific Jira permissions\n\n### Debug Mode\n\nSet environment variable for detailed logging:\n\n```bash\nDEBUG=jira-mcp:* npx @mcp-servers/jira\n```\n\n## Security\n\n- Never commit API tokens to version control\n- Use environment variables or secure secret management\n- Regularly rotate your API tokens\n- Follow your organization's security policies\n\n## License\n\nMIT\n\n## Contributing\n\nIssues and pull requests are welcome! Please see our contributing guidelines.\n\n## Support\n\n- 📖 [Environment Configuration Guide](./ENVIRONMENT_CONFIG.md)\n- 🐛 [Report Issues](https://github.com/your-org/mcp-servers/issues)\n- 💬 [Discussions](https://github.com/your-org/mcp-servers/discussions) ","readmeFilename":"README.md","_rev":"1-dd6cff39bcec6d833b979799cdb9ce5e"}