{"_id":"@ahmetbarut/jira-mcp-server","_rev":"4-69f0c57401b33ec717b2116684db9bea","name":"@ahmetbarut/jira-mcp-server","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@ahmetbarut/jira-mcp-server","version":"1.0.0","keywords":[],"author":"","license":"ISC","_id":"@ahmetbarut/jira-mcp-server@1.0.0","maintainers":[{"name":"ahmetbarut","email":"ahmetbarut588@gmail.com"}],"dist":{"shasum":"c5b48c76d515efb4f2805344c1e3cae342c97c85","tarball":"https://registry.npmjs.org/@ahmetbarut/jira-mcp-server/-/jira-mcp-server-1.0.0.tgz","fileCount":14,"integrity":"sha512-pfIExSe2EmPknSAQMJIGGEkfkOVfzjKJKAAfDGg7yuaIH/AjR/xYsudi7EH0lRgGIquQ6jzB9c53zCmj+MdH5A==","signatures":[{"sig":"MEYCIQCL2d7vZrr//7lwAAAqocieEKk6/HaJBAlZeUYDIC9rPgIhAPRGRm7CEkFIl9jP+RfBJJ/wRmdENHUSEtyOo5Ec4JpO","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29574},"main":"index.js","type":"module","gitHead":"f01bf88525202b5305df45c2d43f34d359061a2e","scripts":{"dev":"ts-node --esm src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"ahmetbarut","email":"ahmetbarut588@gmail.com"},"_npmVersion":"10.9.2","description":"A modular, extensible Model Context Protocol (MCP) server for interacting with Jira Cloud. This project provides a set of tools to query boards, issues, user information, and more, making it easy to integrate Jira with AI agents, bots, or other automation","directories":{},"_nodeVersion":"23.11.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.8.3","@types/node":"^22.15.30"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.0_1749165148089_0.5548734045966586","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@ahmetbarut/jira-mcp-server","version":"1.0.1","keywords":[],"author":{"name":"ahmetbarut"},"license":"MIT","_id":"@ahmetbarut/jira-mcp-server@1.0.1","maintainers":[{"name":"ahmetbarut","email":"ahmetbarut588@gmail.com"}],"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"cad6bf6367f61b7a63fcfd39fcf221ccecd23aa0","tarball":"https://registry.npmjs.org/@ahmetbarut/jira-mcp-server/-/jira-mcp-server-1.0.1.tgz","fileCount":8,"integrity":"sha512-lvY+uBVr6CMYXNNj30IMCpsHVZwDbWX+WqrevCMwLuoV11Rkz2/ZdKpoVz5JvAJa2w4B1FlWK9xTMICX+irkow==","signatures":[{"sig":"MEUCIQD7zQCtK+cxgf+9uq5vFfqGY6gLf9qnFBlGp9x713cQPQIgK4J1j5WP7soEWi/MNer+yPZaQVcZS662/ydgOWB8ZSI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18308},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"8411870d1fcd34d14353d9c67c0b03dbe5e506b8","scripts":{"dev":"ts-node --esm src/index.ts","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"ahmetbarut","email":"ahmetbarut588@gmail.com"},"_npmVersion":"10.9.2","description":"MCP server for using the Jira Cloud API","directories":{},"_nodeVersion":"23.11.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.8.3","@types/node":"^22.15.30"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.1_1749165666078_0.08525138904154494","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@ahmetbarut/jira-mcp-server","version":"1.0.2","keywords":[],"author":{"name":"ahmetbarut"},"license":"MIT","_id":"@ahmetbarut/jira-mcp-server@1.0.2","maintainers":[{"name":"ahmetbarut","email":"ahmetbarut588@gmail.com"}],"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"fdd71efca9255a685fdc4e0d93cccaa698c8abdf","tarball":"https://registry.npmjs.org/@ahmetbarut/jira-mcp-server/-/jira-mcp-server-1.0.2.tgz","fileCount":8,"integrity":"sha512-34zB0u7FnlwfFNbA5ugMARMq2KNEGDZ9K4HtjV0arVGKsyRPk1RMayLU7KgvtOZuOdKVI0RPybYJR5f1hlcBAw==","signatures":[{"sig":"MEQCIGvL0kbx5/f1g4UeiCk/ChQCkV8NMfFNil0EytWpB6VPAiARa0/i8vuI1oC3ZQAv91MeSDtGLuVBVlcMeP2V29yW0Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18328},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"8411870d1fcd34d14353d9c67c0b03dbe5e506b8","scripts":{"dev":"ts-node --esm src/index.ts","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"ahmetbarut","email":"ahmetbarut588@gmail.com"},"_npmVersion":"10.9.2","description":"MCP server for using the Jira Cloud API","directories":{},"_nodeVersion":"23.11.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.8.3","@types/node":"^22.15.30"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.2_1749165869341_0.5281218717225316","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@ahmetbarut/jira-mcp-server","version":"1.1.0","description":"MCP server for using the Jira Cloud API","license":"MIT","author":{"name":"ahmetbarut"},"type":"module","main":"dist/index.js","bin":{"jira-mcp-server":"dist/index.js"},"publishConfig":{"access":"public"},"engines":{"node":">=18"},"scripts":{"build":"tsc && chmod +x dist/index.js","prepare":"npm run build","start":"node dist/index.js","dev":"ts-node --esm src/index.ts","test":"jest","test:watch":"jest --watch","test:coverage":"jest --coverage","lint":"echo 'No linter configured yet - consider adding ESLint' && exit 0","prepublishOnly":"npm run build"},"keywords":[],"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"devDependencies":{"@types/jest":"^29.5.12","@types/node":"^22.15.30","jest":"^29.7.0","ts-jest":"^29.1.2","ts-node":"^10.9.2","typescript":"^5.8.3"},"_id":"@ahmetbarut/jira-mcp-server@1.1.0","gitHead":"878b846a398d72b2e1ec1cc6a50446b1ff5bec2b","_nodeVersion":"23.11.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-IZ04Ag6E+OXBsND/HMNsbzylOs4yvDzSn8qB0lj9HlWeMJcpRpM/G5IYirDsUiCik5PRGi3hDuxZesxijTMXCQ==","shasum":"a8cfc08225cbdd01d0007ac5551ef9ed220f4026","tarball":"https://registry.npmjs.org/@ahmetbarut/jira-mcp-server/-/jira-mcp-server-1.1.0.tgz","fileCount":8,"unpackedSize":22642,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCxqecv+3RF1NmORk35azR3512Sb4NFn1SR+XqYK/BSrwIgFdiXmhD27db5h263hei2jW0Z2XzGrj2fHgtoH+XHb4k="}]},"_npmUser":{"name":"ahmetbarut","email":"ahmetbarut588@gmail.com"},"directories":{},"maintainers":[{"name":"ahmetbarut","email":"ahmetbarut588@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jira-mcp-server_1.1.0_1749549313351_0.5121232397156616"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-05T23:12:28.006Z","modified":"2025-06-10T09:55:13.895Z","1.0.0":"2025-06-05T23:12:28.283Z","1.0.1":"2025-06-05T23:21:06.248Z","1.0.2":"2025-06-05T23:24:29.540Z","1.1.0":"2025-06-10T09:55:13.722Z"},"author":{"name":"ahmetbarut"},"license":"MIT","keywords":[],"description":"MCP server for using the Jira Cloud API","maintainers":[{"name":"ahmetbarut","email":"ahmetbarut588@gmail.com"}],"readme":"# Jira MCP Server\n\nA modular, extensible Model Context Protocol (MCP) server for interacting with Jira Cloud. This project provides a set of tools to query boards, issues, user information, and more, making it easy to integrate Jira with AI agents, bots, or other automation systems.\n\n## 🚀 Features\n\n- List all available Jira scrum boards\n- List your own issues for a specific board\n- Add comments to Jira issues (ADF-compliant)\n- Get current authenticated user information\n- Search for users by login, email, or display name\n- Get Jira server information (including server time)\n- Modular, extensible, and easy to contribute\n\n## 🛠️ Requirements\n\n- Node.js 18+\n- Access to a Jira Cloud instance\n- Jira API Token (see [Jira API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens))\n\n## ⚙️ Environment Variables\n\nSet the following environment variables in your shell or `.env` file:\n\n```\nJIRA_BASE_URL=https://your-domain.atlassian.net\nJIRA_EMAIL=your-email@company.com\nJIRA_API_TOKEN=your-jira-api-token\n```\n\n## 🚀 Quick Start (with npx)\n\nYou can run the Jira MCP Server instantly with npx, no global install required:\n\n```bash\nnpx -y @ahmetbarut/jira-mcp-server\n```\n\nOr, if you want to use it as an MCP tool in a config file (e.g. `mcp.json`):\n\n```json\n{\n  \"Jira MCP Server\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@ahmetbarut/jira-mcp-server\"],\n    \"env\": {\n      \"JIRA_BASE_URL\": \"https://your-domain.atlassian.net\",\n      \"JIRA_EMAIL\": \"your-email@company.com\",\n      \"JIRA_API_TOKEN\": \"your-jira-api-token\"\n    }\n  }\n}\n```\n\n- No need for `npm install` or global install.\n- All dependencies are handled by `npx`.\n- You can set your Jira credentials in the `env` section.\n\n> **Note:** The first run may take a few seconds as `npx` downloads the package.\n\n## 📦 Installation & Setup\n\n1. **Clone the repository (optional):**\n   ```bash\n   git clone https://github.com/ahmetbarut/jira-mcp.git\n   cd jira-mcp-server\n   ```\n2. **Install globally (optional):**\n   ```bash\n   npm install -g @ahmetbarut/jira-mcp-server\n   ```\n3. **Set environment variables:**\n   - See above for required variables.\n4. **Build the project (if using from source):**\n   ```bash\n   npm run build\n   ```\n5. **Run the server:**\n   ```bash\n   jira-mcp-server\n   # or\n   npx -y @ahmetbarut/jira-mcp-server\n   ```\n\n## 🧩 Usage\n\nThis server is designed to be used as an MCP tool server, typically via stdio. You can interact with it using the [Model Context Protocol Inspector](https://github.com/modelcontextprotocol/inspector) or integrate it into your own MCP-compatible agent.\n\n### Example: List Boards\n```bash\nnpx @modelcontextprotocol/inspector --cli npx -y @ahmetbarut/jira-mcp-server --method tools/call --tool-name get_boards\n```\n\n### Example: Get Your Issues for a Board\n```bash\nnpx @modelcontextprotocol/inspector --cli npx -y @ahmetbarut/jira-mcp-server --method tools/call --tool-name get_issues --tool-arg boardId=123\n```\n\n### Example: Add a Comment to an Issue\n```bash\nnpx @modelcontextprotocol/inspector --cli npx -y @ahmetbarut/jira-mcp-server --method tools/call --tool-name add_comment_to_issue --tool-arg issueIdOrKey=PROJ-123 --tool-arg body=\"This is a test comment.\"\n```\n\n## 🧰 Available Tools\n\n- **get_boards**: List all available Jira scrum boards\n- **get_issues**: List your issues for a specific board\n- **add_comment_to_issue**: Add a comment to a Jira issue (ADF-compliant)\n- **get_current_user_info**: Get current authenticated user information\n- **search_user**: Search for a user by login, email, or display name\n- **get_server_info**: Get Jira server information (including server time)\n\n## 🏗️ Project Structure\n\n- `src/index.ts` — Main server entry point and tool dispatcher\n- `src/tools.ts` — Tool definitions and schemas\n- `src/handlers.ts` — Tool handler implementations (business logic)\n- `src/jiraApi.ts` — Jira API helpers and configuration\n- `src/types.ts` — TypeScript types and interfaces\n\n## 🤝 Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. **Fork the repository**\n2. **Create a new branch** for your feature or bugfix:\n   ```bash\n   git checkout -b my-feature\n   ```\n3. **Write clear, well-documented code**\n4. **Add or update tests** if applicable\n5. **Open a pull request** with a clear description of your changes\n6. **Ensure your code passes lint and build checks**\n\n### Code Style\n- Use TypeScript and follow the existing modular structure\n- Keep business logic in `handlers.ts` and API helpers in `jiraApi.ts`\n- Write clear commit messages\n\n### Issues\nIf you find a bug or have a feature request, please open an issue on GitHub with as much detail as possible.\n\n## 📄 License\n\nThis project is licensed under the MIT License. See [LICENSE](LICENSE) for details.\n\n---\n\n**Happy automating with Jira MCP Server!** \n","readmeFilename":"README.md"}