@atlassian-dc-mcp/jira 0.3.2 → 0.3.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/README.md +123 -0
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,14 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
5
5
|
|
|
6
|
+
## [0.3.4](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.3...v0.3.4) (2025-03-08)
|
|
7
|
+
|
|
8
|
+
**Note:** Version bump only for package @atlassian-dc-mcp/jira
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
6
14
|
## [0.3.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.1...v0.3.2) (2025-03-07)
|
|
7
15
|
|
|
8
16
|
|
package/README.md
ADDED
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
# Atlassian Jira Data Center MCP
|
|
2
|
+
|
|
3
|
+
This package provides a Machine Comprehension Protocol (MCP) server for interacting with Atlassian Jira Data Center edition.
|
|
4
|
+
|
|
5
|
+
## Claude Desktop Configuration
|
|
6
|
+
|
|
7
|
+
To use this MCP connector with Claude Desktop, add the following to your Claude Desktop configuration:
|
|
8
|
+
|
|
9
|
+
macOS:
|
|
10
|
+
```
|
|
11
|
+
~/Library/Application Support/Claude/claude_desktop_config.json
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
Windows:
|
|
15
|
+
```
|
|
16
|
+
%APPDATA%\Claude\claude_desktop_config.json
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
```json
|
|
20
|
+
{
|
|
21
|
+
"mcpServers": {
|
|
22
|
+
"atlassian-jira-dc": {
|
|
23
|
+
"command": "npx",
|
|
24
|
+
"args": ["-y", "@atlassian-dc-mcp/jira"],
|
|
25
|
+
"env": {
|
|
26
|
+
"JIRA_HOST": "your-jira-host",
|
|
27
|
+
"JIRA_API_TOKEN": "your-token"
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Note: Set `JIRA_HOST` variable only to domain + port without protocol (e.g., `your-instance.atlassian.net`). The https protocol is assumed.
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
## Features
|
|
38
|
+
|
|
39
|
+
- Search for issues using JQL (Jira Query Language)
|
|
40
|
+
- Get issue details by key
|
|
41
|
+
- Get issue comments
|
|
42
|
+
- Create and update issues
|
|
43
|
+
- Add comments to issues
|
|
44
|
+
|
|
45
|
+
## Setup
|
|
46
|
+
|
|
47
|
+
1. Install dependencies:
|
|
48
|
+
```
|
|
49
|
+
npm install
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
2. Create a `.env` file in the packages/jira directory with the following variables:
|
|
53
|
+
```
|
|
54
|
+
JIRA_HOST=your-jira-instance.atlassian.net
|
|
55
|
+
JIRA_API_TOKEN=your-personal-access-token
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
To create a personal access token:
|
|
59
|
+
- In Jira, select your profile picture at the top right
|
|
60
|
+
- Select **Personal Access Tokens**
|
|
61
|
+
- Select **Create token** and give it a name
|
|
62
|
+
- Copy the token and store it securely (you won't be able to see it again)
|
|
63
|
+
|
|
64
|
+
## Usage
|
|
65
|
+
|
|
66
|
+
Start the MCP server:
|
|
67
|
+
|
|
68
|
+
```
|
|
69
|
+
npm run build
|
|
70
|
+
npm start
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Or for development with auto-reload:
|
|
74
|
+
|
|
75
|
+
```
|
|
76
|
+
npm run dev
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### Available Tools
|
|
80
|
+
|
|
81
|
+
#### 1. jira_searchIssues
|
|
82
|
+
|
|
83
|
+
Search for JIRA issues using JQL in the JIRA Data Center edition instance.
|
|
84
|
+
|
|
85
|
+
Parameters:
|
|
86
|
+
- `jql` (string, required): JIRA Query Language search string
|
|
87
|
+
- `expand` (array, optional): Fields to expand in the response
|
|
88
|
+
- `startAt` (number, optional): Starting index for pagination
|
|
89
|
+
- `maxResults` (number, optional): Maximum number of results to return (default: 10)
|
|
90
|
+
|
|
91
|
+
#### 2. jira_getIssue
|
|
92
|
+
|
|
93
|
+
Get details of a JIRA issue by its key from the JIRA Data Center edition instance.
|
|
94
|
+
|
|
95
|
+
Parameters:
|
|
96
|
+
- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
|
|
97
|
+
- `expand` (string, optional): Comma-separated list of fields to expand
|
|
98
|
+
|
|
99
|
+
#### 3. jira_getIssueComments
|
|
100
|
+
|
|
101
|
+
Get comments for a JIRA issue from the JIRA Data Center edition instance.
|
|
102
|
+
|
|
103
|
+
Parameters:
|
|
104
|
+
- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
|
|
105
|
+
- `expand` (string, optional): Comma-separated list of fields to expand
|
|
106
|
+
|
|
107
|
+
#### 4. jira_createIssue
|
|
108
|
+
|
|
109
|
+
Create a new issue in the JIRA Data Center edition instance.
|
|
110
|
+
|
|
111
|
+
Parameters:
|
|
112
|
+
- `projectId` (string, required): ID of the project
|
|
113
|
+
- `summary` (string, required): Issue summary
|
|
114
|
+
- `description` (string, required): Issue description in format suitable for JIRA Data Center edition (JIRA Wiki Markup)
|
|
115
|
+
- `issueTypeId` (string, required): ID of the issue type
|
|
116
|
+
|
|
117
|
+
#### 5. jira_postIssueComment
|
|
118
|
+
|
|
119
|
+
Add a comment to a JIRA issue in the JIRA Data Center edition instance.
|
|
120
|
+
|
|
121
|
+
Parameters:
|
|
122
|
+
- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
|
|
123
|
+
- `comment` (string, required): Comment text in format suitable for JIRA Data Center edition (JIRA Wiki Markup)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@atlassian-dc-mcp/jira",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.4",
|
|
4
4
|
"main": "build/index.js",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": "./bin/run.js",
|
|
@@ -29,5 +29,5 @@
|
|
|
29
29
|
"publishConfig": {
|
|
30
30
|
"access": "public"
|
|
31
31
|
},
|
|
32
|
-
"gitHead": "
|
|
32
|
+
"gitHead": "c376e231e47a6877a981b2601d8a3d4812f21868"
|
|
33
33
|
}
|