{"_id":"@andrewyun/jira-9-12-14-mcp-server","_rev":"6-ee72de1013651dc515be72452558e6d4","name":"@andrewyun/jira-9-12-14-mcp-server","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.0":{"name":"@andrewyun/jira-9-12-14-mcp-server","version":"1.0.0","keywords":["jira","mcp","model-context-protocol","claude","ai"],"license":"MIT","_id":"@andrewyun/jira-9-12-14-mcp-server@1.0.0","maintainers":[{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"}],"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"5ac607329a7ecf8f2ac6bc1ea6b8cd5843d291fc","tarball":"https://registry.npmjs.org/@andrewyun/jira-9-12-14-mcp-server/-/jira-9-12-14-mcp-server-1.0.0.tgz","fileCount":7,"integrity":"sha512-SI9i1vgTtF1lIjXGkGNh52Q/QXc+w7rjzBRzUb2exsoAdQa9JyW0aURyJnOCp1woUnAMh3w6aP5KNEQavcfIzA==","signatures":[{"sig":"MEQCIBu4XTqsKBNb2UQ3p/BC6Tk9tZTposRpZjfCvXlKKPvpAiBEiDwp+3M8Q61IoB8hRYd0NnOurvjve9iTe/JXQYtAug==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16671},"main":"dist/index.js","type":"module","engines":{"node":">=16"},"gitHead":"0476495bc5091bf0d8d5edd25337f6e1598d7162","scripts":{"build":"tsc && npm run make-executable","start":"node dist/index.js","watch":"tsc --watch","prepare":"npm run build","postinstall":"node dist/postinstall.js","make-executable":"shx chmod +x dist/*.js"},"_npmUser":{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"},"_npmVersion":"10.8.2","description":"MCP Server for Jira 9.12.14 API","directories":{},"_nodeVersion":"20.18.2","dependencies":{"zod":"^3.22.4","dotenv":"^16.3.1","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.3.3","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-9-12-14-mcp-server_1.0.0_1743144786142_0.6497242156750236","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@andrewyun/jira-9-12-14-mcp-server","version":"1.0.1","keywords":["jira","mcp","model-context-protocol","claude","ai"],"license":"MIT","_id":"@andrewyun/jira-9-12-14-mcp-server@1.0.1","maintainers":[{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"}],"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"6db1d3d9621d9abc3e94ce6d5905c93b7bec15e6","tarball":"https://registry.npmjs.org/@andrewyun/jira-9-12-14-mcp-server/-/jira-9-12-14-mcp-server-1.0.1.tgz","fileCount":7,"integrity":"sha512-prqtpjAItVKvMyGwq/8K8iWoWByWTWVVNXRdgWIyabk+Ofh2VuhkEauYAx2CV/r4nXKGq5i/mNM4WGzdSgfBcQ==","signatures":[{"sig":"MEQCIHiKuDebSpWnah3JIJZ83TGN+pQUYb6OJPlFNHyKs6S0AiAjrjV/uSPldoh650hk5wE2uPGZRxYOsRIom0LmuR7ZSg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16690},"main":"dist/index.js","type":"module","engines":{"node":">=16"},"gitHead":"0476495bc5091bf0d8d5edd25337f6e1598d7162","scripts":{"build":"tsc && npm run make-executable","start":"node dist/index.js","watch":"tsc --watch","prepare":"npm run build","postinstall":"node dist/postinstall.js","make-executable":"shx chmod +x dist/*.js"},"_npmUser":{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"},"_npmVersion":"10.8.2","description":"MCP Server for Jira 9.12.14 API","directories":{},"_nodeVersion":"20.18.2","dependencies":{"zod":"^3.22.4","dotenv":"^16.3.1","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.3.3","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-9-12-14-mcp-server_1.0.1_1743145056679_0.22117750600591668","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@andrewyun/jira-9-12-14-mcp-server","version":"1.0.2","keywords":["jira","mcp","model-context-protocol","claude","ai"],"license":"MIT","_id":"@andrewyun/jira-9-12-14-mcp-server@1.0.2","maintainers":[{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"}],"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"95bdbf21296f8e7df5846c017f0e95b6f47d3502","tarball":"https://registry.npmjs.org/@andrewyun/jira-9-12-14-mcp-server/-/jira-9-12-14-mcp-server-1.0.2.tgz","fileCount":7,"integrity":"sha512-WyfXW2t+nBjZIB29BJuF1xQMjvPjSoLipSZzPWlZVQDxoO8ky/kNM+ZBESqPkIFkSeVr+nxdCgzDHczp2liwVQ==","signatures":[{"sig":"MEQCIB3/yu5PaCWw3wB6IBywwvh/Si3uqmPHJTgo5N19sfYbAiAewJoKrnCbFdrbVNpFpnRPWCQnI/7fAxDil0/TfG+XYA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16709},"main":"dist/index.js","type":"module","engines":{"node":">=16"},"gitHead":"0476495bc5091bf0d8d5edd25337f6e1598d7162","scripts":{"build":"tsc && npm run make-executable","start":"node dist/index.js","watch":"tsc --watch","prepare":"npm run build","postinstall":"node dist/postinstall.js","make-executable":"shx chmod +x dist/*.js"},"_npmUser":{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"},"_npmVersion":"10.8.2","description":"MCP Server for Jira 9.12.14 API","directories":{},"_nodeVersion":"20.18.2","dependencies":{"zod":"^3.22.4","dotenv":"^16.3.1","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.3.3","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-9-12-14-mcp-server_1.0.2_1743145144070_0.2984163633321508","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@andrewyun/jira-9-12-14-mcp-server","version":"1.0.3","keywords":["jira","mcp","model-context-protocol","claude","ai"],"license":"MIT","_id":"@andrewyun/jira-9-12-14-mcp-server@1.0.3","maintainers":[{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"}],"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"211f3bf49af9473594bd75bfc01374c5e7289aaa","tarball":"https://registry.npmjs.org/@andrewyun/jira-9-12-14-mcp-server/-/jira-9-12-14-mcp-server-1.0.3.tgz","fileCount":7,"integrity":"sha512-w8SwGfm5Lm0uFplOdqOeyuch/uCkQ0L7SPxaditBQREHQaZkI4LoDuYAEMecCdu6f+Joi8Fbh+oyA0oX/G/ilA==","signatures":[{"sig":"MEUCIF5i3ER65DlE7SCtXDLXgLwVXFUx82FAm2GGnsOWWZ06AiEAtusLVXl79NuhwzxGmAc+G5yxKP09K+SEj+7P8rW1D1M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18463},"main":"dist/index.js","type":"module","engines":{"node":">=16"},"gitHead":"0476495bc5091bf0d8d5edd25337f6e1598d7162","scripts":{"build":"tsc && npm run make-executable","start":"node dist/index.js","watch":"tsc --watch","prepare":"npm run build","postinstall":"node dist/postinstall.js","make-executable":"shx chmod +x dist/*.js"},"_npmUser":{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"},"_npmVersion":"10.8.2","description":"MCP Server for Jira 9.12.14 API","directories":{},"_nodeVersion":"20.18.2","dependencies":{"zod":"^3.22.4","dotenv":"^16.3.1","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.3.3","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-9-12-14-mcp-server_1.0.3_1743145590007_0.6345734181700025","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@andrewyun/jira-9-12-14-mcp-server","version":"1.0.4","keywords":["jira","mcp","model-context-protocol","claude","ai"],"license":"MIT","_id":"@andrewyun/jira-9-12-14-mcp-server@1.0.4","maintainers":[{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"}],"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"a7eb77befc6f59df700eba7febce7d659c7722c3","tarball":"https://registry.npmjs.org/@andrewyun/jira-9-12-14-mcp-server/-/jira-9-12-14-mcp-server-1.0.4.tgz","fileCount":7,"integrity":"sha512-GT3KnoP9NIJ0htSHwP9f+tqTIpEz4PMOeXJf4KH8KpBzkYjcvtaHouTfq62ldtD7vpGGMl20m/lL62rqhF1Tqw==","signatures":[{"sig":"MEUCIQCdhXXpgRQQ6O72Rd5n5uqJ6SBqG+N3kbvYREVdjKUl2QIgLztDUk7YwFDt40K/WCBMCBYUROq9PkzVLxicGr2q2yo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18901},"main":"dist/index.js","type":"module","engines":{"node":">=16"},"gitHead":"0476495bc5091bf0d8d5edd25337f6e1598d7162","scripts":{"build":"tsc && npm run make-executable","start":"node dist/index.js","watch":"tsc --watch","prepare":"npm run build","postinstall":"node dist/postinstall.js","make-executable":"shx chmod +x dist/*.js"},"_npmUser":{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"},"_npmVersion":"10.8.2","description":"MCP Server for Jira 9.12.14 API","directories":{},"_nodeVersion":"20.18.2","dependencies":{"zod":"^3.22.4","dotenv":"^16.3.1","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.3.3","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-9-12-14-mcp-server_1.0.4_1743146472039_0.4249069986387326","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@andrewyun/jira-9-12-14-mcp-server","version":"1.0.5","description":"MCP Server for Jira 9.12.14 API","license":"MIT","type":"module","main":"dist/index.js","bin":{"jira-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && npm run make-executable","make-executable":"shx chmod +x dist/*.js","prepare":"npm run build","watch":"tsc --watch","start":"node dist/index.js","postinstall":"node dist/postinstall.js"},"keywords":["jira","mcp","model-context-protocol","claude","ai"],"engines":{"node":">=16"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"1.7.0","dotenv":"^16.3.1","zod":"^3.22.4","node-fetch":"^3.3.2"},"devDependencies":{"@types/node":"^22.0.0","shx":"^0.3.4","typescript":"^5.3.3"},"_id":"@andrewyun/jira-9-12-14-mcp-server@1.0.5","gitHead":"0476495bc5091bf0d8d5edd25337f6e1598d7162","_nodeVersion":"20.18.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-6ZjmvMBquDysww5A3uE+B2QOxJFut45JqylS264vnGfKpo6HQJjYWz9YD0ZDt4oCYWbc+oLw9IHK33C3EuGnpQ==","shasum":"b8ba3fa0e4987662921515ecc6103276da3150fe","tarball":"https://registry.npmjs.org/@andrewyun/jira-9-12-14-mcp-server/-/jira-9-12-14-mcp-server-1.0.5.tgz","fileCount":7,"unpackedSize":18860,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD/hqz/nMs3kJvqQ2AassIw8rTLXasIQuEnDuS6hUG+AwIgEnbbw5K72WxfxPSx1l2KPq3DO9xQgjduH6JEOvtyimE="}]},"_npmUser":{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"},"directories":{},"maintainers":[{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jira-9-12-14-mcp-server_1.0.5_1743146659035_0.5762018573819072"},"_hasShrinkwrap":false}},"time":{"created":"2025-03-28T06:53:06.059Z","modified":"2025-03-28T07:24:19.389Z","1.0.0":"2025-03-28T06:53:06.322Z","1.0.1":"2025-03-28T06:57:36.851Z","1.0.2":"2025-03-28T06:59:04.296Z","1.0.3":"2025-03-28T07:06:30.191Z","1.0.4":"2025-03-28T07:21:12.211Z","1.0.5":"2025-03-28T07:24:19.227Z"},"license":"MIT","keywords":["jira","mcp","model-context-protocol","claude","ai"],"description":"MCP Server for Jira 9.12.14 API","maintainers":[{"name":"andrewyun","email":"andrew.tc.yun@gmail.com"}],"readme":"# Jira 9.12.14 MCP Server\n\nThis is a Model Context Protocol (MCP) server implementation for the Jira 9.12.14 API. It allows AI models like Claude to securely interact with Jira through well-defined tools.\n\n## Features\n\n- **JQL Search**: Execute JQL queries to find issues in Jira\n- **Get Issue**: Retrieve detailed information about a specific issue by ID or key\n\n## Prerequisites\n\n- Node.js (v16 or higher)\n- npm or yarn\n- A Jira instance\n- Authentication credentials for Jira API\n\n## Installation\n\n### Option 1: Using npx (Recommended)\n\nThe easiest way to use this MCP server is with npx:\n\n```bash\n# Create a directory for your configuration\nmkdir jira-mcp && cd jira-mcp\n\n# Create .env file with your credentials\ncat > .env << EOL\nJIRA_API_URL=https://your-domain.atlassian.net\nJIRA_AUTH_TOKEN=your-token-here\nEOL\n\n# Run the server directly\nnpx @andrewyun/jira-9-12-14-mcp-server\n```\n\n### Option 2: Manual Installation\n\n1. Clone the repository\n2. Install dependencies:\n\n```bash\nnpm install\n```\n\n3. Build the project:\n\n```bash\nnpm run build\n```\n\n## Configuration\n\n### Option 1: Environment Variables in .env File\n\nThe server reads configuration from a `.env` file in the current directory. Create a file named `.env` with the following settings:\n\n```\nJIRA_API_URL=https://your-domain.atlassian.net\nJIRA_AUTH_TOKEN=your-jira-token\n```\n\nYou must create this file in the directory where you run the server.\n\n### Option 2: MCP JSON Environment Variables\n\nAs an alternative to the .env file, you can configure the server using MCP JSON environment variables. Update your Claude for Desktop configuration in the `mcpServers` section:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/ABSOLUTE/PATH/TO/jira-9.12.14-mcp-server/dist/index.js\"\n      ],\n      \"env\": {\n        \"MCP_JIRA_API_URL\": \"https://your-domain.atlassian.net\",\n        \"MCP_JIRA_AUTH_TOKEN\": \"your-jira-token\"\n      }\n    }\n  }\n}\n```\n\nUsing the MCP JSON environment variables means you don't need to create a .env file.\n\n### Environment Variable Details\n\n- `JIRA_API_URL` or `MCP_JIRA_API_URL`: The base URL of your Jira instance (e.g., `https://your-domain.atlassian.net`)\n- `JIRA_AUTH_TOKEN` or `MCP_JIRA_AUTH_TOKEN`: Your Jira API token or Personal Access Token (PAT)\n\n### Getting a Jira API Token\n\n1. Log in to your Atlassian account\n2. Go to Account Settings > Security > Create and manage API tokens\n3. Click \"Create API token\"\n4. Give it a name like \"MCP Server\"\n5. Copy the generated token to your `.env` file or MCP JSON configuration\n\n## Usage\n\n### Running the server\n\n```bash\nnpm start\n```\n\n### Integration with Claude for Desktop\n\n1. Open your Claude for Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` (MacOS) or `%AppData%\\Claude\\claude_desktop_config.json` (Windows)\n2. Add the server configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/ABSOLUTE/PATH/TO/jira-9.12.14-mcp-server/dist/index.js\"\n      ],\n      \"env\": {\n        \"MCP_JIRA_API_URL\": \"https://your-domain.atlassian.net\",\n        \"MCP_JIRA_AUTH_TOKEN\": \"your-jira-token\"\n      }\n    }\n  }\n}\n```\n\nReplace `/ABSOLUTE/PATH/TO/` with the actual path to the server on your system.\n\n#### Using With npx\n\nIf you installed via npx, your Claude configuration would look like:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"--yes\",\n        \"@andrewyun/jira-9-12-14-mcp-server\"\n      ],\n      \"env\": {\n        \"MCP_JIRA_API_URL\": \"https://your-domain.atlassian.net\",\n        \"MCP_JIRA_AUTH_TOKEN\": \"your-jira-token\"\n      }\n    }\n  }\n}\n```\n\n**Important**: If you're using the MCP JSON environment variables, you don't need a `.env` file. If you're not using MCP JSON environment variables, make sure you have a `.env` file in your home directory or in the directory where Claude for Desktop is installed when using npx.\n\n## Available Tools\n\n### JQL Search (`mcp_jira_jql_search`)\n\nExecutes JQL queries to find issues in Jira.\n\n**Parameters:**\n- `jql` (required): JQL query string\n- `fields` (optional): List of fields to return for each issue\n- `maxResults` (optional): Maximum number of results to return\n- `startAt` (optional): Index of the first result to return\n- `expand` (optional): Additional information to include in the response\n\n### Get Issue (`mcp_jira_get_issue`)\n\nRetrieves detailed information about a specific issue by ID or key.\n\n**Parameters:**\n- `issueIdOrKey` (required): ID or key of the issue\n- `fields` (optional): List of fields to include in the response\n- `expand` (optional): Additional information to include in the response\n- `properties` (optional): Properties to include in the response\n- `failFast` (optional): Whether to fail quickly on errors (default: false)\n\n## Troubleshooting\n\nIf you see errors like `JIRA_API_URL environment variable is required`, make sure you:\n\n1. Have created a `.env` file in the directory where you're running the server, OR\n2. Have provided `MCP_JIRA_API_URL` and `MCP_JIRA_AUTH_TOKEN` in your Claude for Desktop configuration\nMIT ","readmeFilename":"README.md"}