@khanglvm/jira-mcp 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 khanglvm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# @khanglvm/jira-mcp
+
+MCP server for **legacy Jira Server** (v7.x) with Basic Authentication. Works with any MCP-compatible AI tool.
+
+> **🔔 Using Jira Cloud or Data Center 8.14+?** Use [mcp-atlassian](https://github.com/sooperset/mcp-atlassian) instead for OAuth/PAT support.
+
+---
+
+## 📋 Prerequisites
+
+**Node.js** (v18+) is required for MCP servers and the installer to work.
+
+**macOS / Linux:**
+```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
+```
+
+**Windows (PowerShell):**
+```powershell
+winget install -e --id OpenJS.NodeJS.LTS
+```
+
+---
+
+## 🚀 Quick Install
+
+Run this single command to interactively configure Jira MCP for your AI tool:
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/khanglvm/jira-mcp/main/scripts/install.sh)
+```
+
+The installer auto-detects installed tools, supports multi-select, safely merges config, and creates backups.
+
+---
+
+## 📦 Configuration Formats
+
+### JSON (camelCase) - Claude Desktop, Claude Code, Antigravity, Cursor
+
+```json
+{
+  "mcpServers": {
+    "jira": {
+      "command": "npx",
+      "args": ["-y", "@khanglvm/jira-mcp"],
+      "env": {
+        "JIRA_BASE_URL": "http://jira.example.com:8080",
+        "JIRA_USERNAME": "your-username",
+        "JIRA_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+### JSON (dash-case) - VS Code, GitHub Copilot
+
+```json
+{
+  "servers": {
+    "jira": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@khanglvm/jira-mcp"],
+      "env": {
+        "JIRA_BASE_URL": "http://jira.example.com:8080",
+        "JIRA_USERNAME": "your-username",
+        "JIRA_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+### YAML (Codex)
+
+```yaml
+mcp_servers:
+  jira:
+    command: npx
+    args:
+      - -y
+      - "@khanglvm/jira-mcp"
+    env:
+      JIRA_BASE_URL: http://jira.example.com:8080
+      JIRA_USERNAME: your-username
+      JIRA_PASSWORD: your-password
+```
+
+---
+
+## 🔧 Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `jira_get_issue` | Get issue details by key |
+| `jira_create_issue` | Create a new issue |
+| `jira_update_issue` | Update issue fields |
+| `jira_delete_issue` | Delete an issue |
+| `jira_add_comment` | Add comment to issue |
+| `jira_get_comments` | Get issue comments |
+| `jira_search` | Search issues using JQL |
+| `jira_list_projects` | List all accessible projects |
+| `jira_get_project` | Get project details |
+| `jira_get_transitions` | Get available transitions |
+| `jira_transition_issue` | Transition issue to new status |
+| `jira_get_current_user` | Get authenticated user info |
+| `jira_get_user` | Get user by username |
+
+---
+
+## ⚙️ Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `JIRA_BASE_URL` | ✅ | Jira instance URL |
+| `JIRA_USERNAME` | ✅ | Username |
+| `JIRA_PASSWORD` | ✅ | Password |
+| `JIRA_API_VERSION` | ❌ | API version (default: `2`) |
+
+---
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,287 @@
+/**
+ * @file client.ts
+ * @description Jira REST API client with HTTP Basic Authentication.
+ * Provides typed methods for interacting with Jira Server v7.x API.
+ */
+import { JiraConfig } from './config.js';
+/**
+ * Error thrown when Jira API requests fail.
+ */
+export declare class JiraApiError extends Error {
+    readonly statusCode: number;
+    readonly body?: unknown | undefined;
+    constructor(message: string, statusCode: number, body?: unknown | undefined);
+}
+/**
+ * Jira REST API client with basic authentication.
+ */
+export declare class JiraClient {
+    private readonly config;
+    private readonly apiBaseUrl;
+    private readonly authBaseUrl;
+    private readonly authHeader;
+    /**
+     * Creates a new Jira client instance.
+     * @param config - Validated Jira configuration
+     */
+    constructor(config: JiraConfig);
+    /**
+     * Makes an authenticated request to the Jira API.
+     * @param method - HTTP method
+     * @param path - API path (relative to base URL)
+     * @param body - Optional request body
+     * @param useAuthEndpoint - Whether to use auth endpoint instead of api endpoint
+     * @returns Parsed JSON response
+     */
+    private request;
+    /**
+     * Gets current authenticated user session info.
+     * @returns Current user session data
+     */
+    getCurrentSession(): Promise<JiraSession>;
+    /**
+     * Gets an issue by key or ID.
+     * @param issueIdOrKey - Issue key (e.g., "PROJ-123") or ID
+     * @param fields - Optional comma-separated list of fields to return
+     * @param expand - Optional fields to expand
+     * @returns Issue data
+     */
+    getIssue(issueIdOrKey: string, fields?: string, expand?: string): Promise<JiraIssue>;
+    /**
+     * Creates a new issue.
+     * @param data - Issue creation data
+     * @returns Created issue reference
+     */
+    createIssue(data: CreateIssueInput): Promise<CreatedIssue>;
+    /**
+     * Updates an existing issue.
+     * @param issueIdOrKey - Issue key or ID
+     * @param data - Fields to update
+     */
+    updateIssue(issueIdOrKey: string, data: UpdateIssueInput): Promise<void>;
+    /**
+     * Deletes an issue.
+     * @param issueIdOrKey - Issue key or ID
+     * @param deleteSubtasks - Whether to delete subtasks
+     */
+    deleteIssue(issueIdOrKey: string, deleteSubtasks?: boolean): Promise<void>;
+    /**
+     * Gets comments on an issue.
+     * @param issueIdOrKey - Issue key or ID
+     * @returns Comments data
+     */
+    getComments(issueIdOrKey: string): Promise<CommentsResponse>;
+    /**
+     * Adds a comment to an issue.
+     * @param issueIdOrKey - Issue key or ID
+     * @param body - Comment body text
+     * @returns Created comment
+     */
+    addComment(issueIdOrKey: string, body: string): Promise<JiraComment>;
+    /**
+     * Gets available transitions for an issue.
+     * @param issueIdOrKey - Issue key or ID
+     * @returns Available transitions
+     */
+    getTransitions(issueIdOrKey: string): Promise<TransitionsResponse>;
+    /**
+     * Transitions an issue to a new status.
+     * @param issueIdOrKey - Issue key or ID
+     * @param transitionId - ID of the transition to execute
+     * @param comment - Optional comment to add
+     */
+    transitionIssue(issueIdOrKey: string, transitionId: string, comment?: string): Promise<void>;
+    /**
+     * Searches for issues using JQL.
+     * @param jql - JQL query string
+     * @param maxResults - Maximum results to return (default 50)
+     * @param startAt - Starting index for pagination
+     * @param fields - Fields to include in results
+     * @returns Search results
+     */
+    search(jql: string, maxResults?: number, startAt?: number, fields?: string[]): Promise<SearchResponse>;
+    /**
+     * Gets all accessible projects.
+     * @returns List of projects
+     */
+    getProjects(): Promise<JiraProject[]>;
+    /**
+     * Gets a project by key or ID.
+     * @param projectIdOrKey - Project key or ID
+     * @returns Project data
+     */
+    getProject(projectIdOrKey: string): Promise<JiraProject>;
+    /**
+     * Gets the currently authenticated user.
+     * @returns Current user data
+     */
+    getCurrentUser(): Promise<JiraUser>;
+    /**
+     * Gets a user by username.
+     * @param username - Username to look up
+     * @returns User data
+     */
+    getUser(username: string): Promise<JiraUser>;
+}
+/** Session information from auth endpoint */
+export interface JiraSession {
+    self: string;
+    name: string;
+    loginInfo: {
+        failedLoginCount: number;
+        loginCount: number;
+        lastFailedLoginTime?: string;
+        previousLoginTime?: string;
+    };
+}
+/** Jira issue structure */
+export interface JiraIssue {
+    id: string;
+    key: string;
+    self: string;
+    fields: {
+        summary: string;
+        description?: string;
+        status: {
+            name: string;
+            id: string;
+        };
+        priority?: {
+            name: string;
+            id: string;
+        };
+        assignee?: {
+            displayName: string;
+            name: string;
+            emailAddress?: string;
+        };
+        reporter?: {
+            displayName: string;
+            name: string;
+        };
+        issuetype: {
+            name: string;
+            id: string;
+        };
+        project: {
+            key: string;
+            name: string;
+        };
+        created: string;
+        updated: string;
+        labels?: string[];
+        [key: string]: unknown;
+    };
+}
+/** Input for creating an issue */
+export interface CreateIssueInput {
+    project: {
+        key: string;
+    } | {
+        id: string;
+    };
+    summary: string;
+    issuetype: {
+        name: string;
+    } | {
+        id: string;
+    };
+    description?: string;
+    assignee?: {
+        name: string;
+    };
+    priority?: {
+        name: string;
+    } | {
+        id: string;
+    };
+    labels?: string[];
+    [key: string]: unknown;
+}
+/** Response when creating an issue */
+export interface CreatedIssue {
+    id: string;
+    key: string;
+    self: string;
+}
+/** Input for updating an issue */
+export interface UpdateIssueInput {
+    summary?: string;
+    description?: string;
+    assignee?: {
+        name: string;
+    } | null;
+    priority?: {
+        name: string;
+    } | {
+        id: string;
+    };
+    labels?: string[];
+    [key: string]: unknown;
+}
+/** Jira comment structure */
+export interface JiraComment {
+    id: string;
+    self: string;
+    author: {
+        displayName: string;
+        name: string;
+    };
+    body: string;
+    created: string;
+    updated: string;
+}
+/** Response containing comments */
+export interface CommentsResponse {
+    startAt: number;
+    maxResults: number;
+    total: number;
+    comments: JiraComment[];
+}
+/** Transition information */
+export interface JiraTransition {
+    id: string;
+    name: string;
+    to: {
+        id: string;
+        name: string;
+        statusCategory: {
+            name: string;
+        };
+    };
+}
+/** Response containing transitions */
+export interface TransitionsResponse {
+    transitions: JiraTransition[];
+}
+/** Search response structure */
+export interface SearchResponse {
+    startAt: number;
+    maxResults: number;
+    total: number;
+    issues: JiraIssue[];
+}
+/** Jira project structure */
+export interface JiraProject {
+    id: string;
+    key: string;
+    name: string;
+    self: string;
+    projectTypeKey?: string;
+    lead?: {
+        displayName: string;
+        name: string;
+    };
+    description?: string;
+}
+/** Jira user structure */
+export interface JiraUser {
+    self: string;
+    key: string;
+    name: string;
+    displayName: string;
+    emailAddress?: string;
+    active: boolean;
+    timeZone?: string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -0,0 +1,235 @@
+/**
+ * @file client.ts
+ * @description Jira REST API client with HTTP Basic Authentication.
+ * Provides typed methods for interacting with Jira Server v7.x API.
+ */
+import { getApiBaseUrl, getAuthBaseUrl } from './config.js';
+/**
+ * Error thrown when Jira API requests fail.
+ */
+export class JiraApiError extends Error {
+    statusCode;
+    body;
+    constructor(message, statusCode, body) {
+        super(message);
+        this.statusCode = statusCode;
+        this.body = body;
+        this.name = 'JiraApiError';
+    }
+}
+/**
+ * Jira REST API client with basic authentication.
+ */
+export class JiraClient {
+    config;
+    apiBaseUrl;
+    authBaseUrl;
+    authHeader;
+    /**
+     * Creates a new Jira client instance.
+     * @param config - Validated Jira configuration
+     */
+    constructor(config) {
+        this.config = config;
+        this.apiBaseUrl = getApiBaseUrl(config);
+        this.authBaseUrl = getAuthBaseUrl(config);
+        // Generate Basic auth header: base64(username:password)
+        this.authHeader = `Basic ${Buffer.from(`${config.JIRA_USERNAME}:${config.JIRA_PASSWORD}`).toString('base64')}`;
+    }
+    /**
+     * Makes an authenticated request to the Jira API.
+     * @param method - HTTP method
+     * @param path - API path (relative to base URL)
+     * @param body - Optional request body
+     * @param useAuthEndpoint - Whether to use auth endpoint instead of api endpoint
+     * @returns Parsed JSON response
+     */
+    async request(method, path, body, useAuthEndpoint = false) {
+        const baseUrl = useAuthEndpoint ? this.authBaseUrl : this.apiBaseUrl;
+        const url = `${baseUrl}${path}`;
+        const headers = {
+            Authorization: this.authHeader,
+            Accept: 'application/json',
+        };
+        if (body) {
+            headers['Content-Type'] = 'application/json';
+        }
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        // Handle empty responses (e.g., 204 No Content)
+        if (response.status === 204 || response.headers.get('content-length') === '0') {
+            return {};
+        }
+        const responseBody = await response.text();
+        let parsedBody;
+        try {
+            parsedBody = responseBody ? JSON.parse(responseBody) : {};
+        }
+        catch {
+            parsedBody = responseBody;
+        }
+        if (!response.ok) {
+            let errorMessage = `Request failed with status ${response.status}`;
+            if (typeof parsedBody === 'object' && parsedBody !== null) {
+                const bodyRecord = parsedBody;
+                const errorMessages = bodyRecord.errorMessages;
+                if (Array.isArray(errorMessages) && errorMessages.length > 0) {
+                    errorMessage = String(errorMessages[0]);
+                }
+                else if (typeof bodyRecord.message === 'string') {
+                    errorMessage = bodyRecord.message;
+                }
+            }
+            throw new JiraApiError(errorMessage, response.status, parsedBody);
+        }
+        return parsedBody;
+    }
+    // ============ Session/Auth Methods ============
+    /**
+     * Gets current authenticated user session info.
+     * @returns Current user session data
+     */
+    async getCurrentSession() {
+        return this.request('GET', '/session', undefined, true);
+    }
+    // ============ Issue Methods ============
+    /**
+     * Gets an issue by key or ID.
+     * @param issueIdOrKey - Issue key (e.g., "PROJ-123") or ID
+     * @param fields - Optional comma-separated list of fields to return
+     * @param expand - Optional fields to expand
+     * @returns Issue data
+     */
+    async getIssue(issueIdOrKey, fields, expand) {
+        const params = new URLSearchParams();
+        if (fields)
+            params.set('fields', fields);
+        if (expand)
+            params.set('expand', expand);
+        const query = params.toString() ? `?${params.toString()}` : '';
+        return this.request('GET', `/issue/${issueIdOrKey}${query}`);
+    }
+    /**
+     * Creates a new issue.
+     * @param data - Issue creation data
+     * @returns Created issue reference
+     */
+    async createIssue(data) {
+        return this.request('POST', '/issue', { fields: data });
+    }
+    /**
+     * Updates an existing issue.
+     * @param issueIdOrKey - Issue key or ID
+     * @param data - Fields to update
+     */
+    async updateIssue(issueIdOrKey, data) {
+        await this.request('PUT', `/issue/${issueIdOrKey}`, { fields: data });
+    }
+    /**
+     * Deletes an issue.
+     * @param issueIdOrKey - Issue key or ID
+     * @param deleteSubtasks - Whether to delete subtasks
+     */
+    async deleteIssue(issueIdOrKey, deleteSubtasks = false) {
+        const query = deleteSubtasks ? '?deleteSubtasks=true' : '';
+        await this.request('DELETE', `/issue/${issueIdOrKey}${query}`);
+    }
+    /**
+     * Gets comments on an issue.
+     * @param issueIdOrKey - Issue key or ID
+     * @returns Comments data
+     */
+    async getComments(issueIdOrKey) {
+        return this.request('GET', `/issue/${issueIdOrKey}/comment`);
+    }
+    /**
+     * Adds a comment to an issue.
+     * @param issueIdOrKey - Issue key or ID
+     * @param body - Comment body text
+     * @returns Created comment
+     */
+    async addComment(issueIdOrKey, body) {
+        return this.request('POST', `/issue/${issueIdOrKey}/comment`, {
+            body,
+        });
+    }
+    // ============ Transition Methods ============
+    /**
+     * Gets available transitions for an issue.
+     * @param issueIdOrKey - Issue key or ID
+     * @returns Available transitions
+     */
+    async getTransitions(issueIdOrKey) {
+        return this.request('GET', `/issue/${issueIdOrKey}/transitions`);
+    }
+    /**
+     * Transitions an issue to a new status.
+     * @param issueIdOrKey - Issue key or ID
+     * @param transitionId - ID of the transition to execute
+     * @param comment - Optional comment to add
+     */
+    async transitionIssue(issueIdOrKey, transitionId, comment) {
+        const body = {
+            transition: { id: transitionId },
+        };
+        if (comment) {
+            body.update = {
+                comment: [{ add: { body: comment } }],
+            };
+        }
+        await this.request('POST', `/issue/${issueIdOrKey}/transitions`, body);
+    }
+    // ============ Search Methods ============
+    /**
+     * Searches for issues using JQL.
+     * @param jql - JQL query string
+     * @param maxResults - Maximum results to return (default 50)
+     * @param startAt - Starting index for pagination
+     * @param fields - Fields to include in results
+     * @returns Search results
+     */
+    async search(jql, maxResults = 50, startAt = 0, fields) {
+        return this.request('POST', '/search', {
+            jql,
+            maxResults,
+            startAt,
+            fields: fields ?? ['summary', 'status', 'assignee', 'priority', 'issuetype'],
+        });
+    }
+    // ============ Project Methods ============
+    /**
+     * Gets all accessible projects.
+     * @returns List of projects
+     */
+    async getProjects() {
+        return this.request('GET', '/project');
+    }
+    /**
+     * Gets a project by key or ID.
+     * @param projectIdOrKey - Project key or ID
+     * @returns Project data
+     */
+    async getProject(projectIdOrKey) {
+        return this.request('GET', `/project/${projectIdOrKey}`);
+    }
+    // ============ User Methods ============
+    /**
+     * Gets the currently authenticated user.
+     * @returns Current user data
+     */
+    async getCurrentUser() {
+        return this.request('GET', '/myself');
+    }
+    /**
+     * Gets a user by username.
+     * @param username - Username to look up
+     * @returns User data
+     */
+    async getUser(username) {
+        return this.request('GET', `/user?username=${encodeURIComponent(username)}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}