@atlassian-dc-mcp/jira 0.3.2 → 0.3.5

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.3.5](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.4...v0.3.5) (2025-03-08)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+
+
+
+
+## [0.3.4](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.3...v0.3.4) (2025-03-08)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+
+
+
+
 ## [0.3.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.1...v0.3.2) (2025-03-07)
 
 

package/README.md

@@ -0,0 +1,122 @@
+# Atlassian Jira Data Center MCP
+
+This package provides a Machine Comprehension Protocol (MCP) server for interacting with Atlassian Jira Data Center edition.
+
+## Claude Desktop Configuration
+
+To use this MCP connector with Claude Desktop, add the following to your Claude Desktop configuration:
+
+macOS:
+```
+~/Library/Application Support/Claude/claude_desktop_config.json
+```
+
+Windows:
+```
+%APPDATA%\Claude\claude_desktop_config.json
+```
+
+```json
+{
+  "mcpServers": {
+    "atlassian-jira-dc": {
+      "command": "npx",
+      "args": ["-y", "@atlassian-dc-mcp/jira"],
+      "env": {
+        "JIRA_HOST": "your-jira-host",
+        "JIRA_API_TOKEN": "your-token"
+      }
+    }
+  }
+}
+```
+
+Note: Set `JIRA_HOST` variable only to domain + port without protocol (e.g., `your-instance.atlassian.net`). The https protocol is assumed.
+
+
+## Features
+
+- Search for issues using JQL (Jira Query Language)
+- Get issue details by key
+- Get issue comments
+- Create and update issues
+- Add comments to issues
+
+## Setup
+
+1. Install dependencies:
+   ```
+   npm install
+   ```
+
+2. Create a `.env` file in the packages/jira directory with the following variables:
+   ```
+   JIRA_HOST=your-jira-instance.atlassian.net
+   JIRA_API_TOKEN=your-personal-access-token
+   ```
+
+   To create a personal access token:
+   - In Jira, select your profile picture at the top right
+   - Select **Personal Access Tokens**
+   - Select **Create token** and give it a name
+   - Copy the token and store it securely (you won't be able to see it again)
+
+## Usage
+
+Start the MCP server:
+
+```
+npm run build
+```
+
+Or for development with auto-reload:
+
+```
+npm run dev
+```
+
+### Available Tools
+
+#### 1. jira_searchIssues
+
+Search for JIRA issues using JQL in the JIRA Data Center edition instance.
+
+Parameters:
+- `jql` (string, required): JIRA Query Language search string
+- `expand` (array, optional): Fields to expand in the response
+- `startAt` (number, optional): Starting index for pagination
+- `maxResults` (number, optional): Maximum number of results to return (default: 10)
+
+#### 2. jira_getIssue
+
+Get details of a JIRA issue by its key from the JIRA Data Center edition instance.
+
+Parameters:
+- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
+- `expand` (string, optional): Comma-separated list of fields to expand
+
+#### 3. jira_getIssueComments
+
+Get comments for a JIRA issue from the JIRA Data Center edition instance.
+
+Parameters:
+- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
+- `expand` (string, optional): Comma-separated list of fields to expand
+
+#### 4. jira_createIssue
+
+Create a new issue in the JIRA Data Center edition instance.
+
+Parameters:
+- `projectId` (string, required): ID of the project
+- `summary` (string, required): Issue summary
+- `description` (string, required): Issue description in format suitable for JIRA Data Center edition (JIRA Wiki Markup)
+- `issueTypeId` (string, required): ID of the issue type
+
+#### 5. jira_postIssueComment
+
+Add a comment to a JIRA issue in the JIRA Data Center edition instance.
+
+Parameters:
+- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
+- `comment` (string, required): Comment text in format suitable for JIRA Data Center edition (JIRA Wiki Markup)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlassian-dc-mcp/jira",
-  "version": "0.3.2",
+  "version": "0.3.5",
   "main": "build/index.js",
   "type": "module",
   "bin": "./bin/run.js",
@@ -29,5 +29,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "5dced187a26701fe3724bde6da83c7329740ad92"
+  "gitHead": "7294b60129d13ce6ea8fdf467829b5ba1903b823"
 }