@nexus2520/jira-mcp-server 1.0.1 → 1.1.0

package/README.md

@@ -1,19 +1,21 @@
 # Jira MCP Server
 
 [![npm version](https://badge.fury.io/js/@nexus2520%2Fjira-mcp-server.svg)](https://www.npmjs.com/package/@nexus2520/jira-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A Model Context Protocol (MCP) server for Jira API integration. This server enables AI assistants like Claude to interact with Jira Cloud instances for issue management, search, comments, and workflow transitions.
+A Model Context Protocol (MCP) server for Jira API integration. This server enables AI assistants like Claude to interact with Jira Cloud instances for issue management, search, comments, workflow transitions, and attachment handling.
 
 ## Features
 
 - **Issue Management**: Get, create, update, and assign Jira issues with custom field support
 - **JQL Search**: Search issues using Jira Query Language
-- **Comments**: Add and retrieve comments on issues (supports mentions and links)
+- **Comments**: Add and retrieve comments on issues
 - **Workflow**: Get available transitions and change issue status
 - **Metadata Discovery**: Get field requirements and allowed values for projects
 - **User Search**: Find users by email or name for assignments
 - **Projects**: List all accessible projects
-- **API Token Authentication**: Secure authentication using email + API token
+- **Attachments**: List, upload, delete attachments and retrieve their content — text files returned as text, images rendered inline via Claude vision
+- **Token Efficient**: 5 compound tools instead of 16 flat tools — ~50% fewer tokens per session
 
 ## Installation
 
@@ -51,8 +53,6 @@ npm install -g @nexus2520/jira-mcp-server
 
 ### Environment Variables
 
-The server requires the following environment variables:
-
 - `JIRA_EMAIL`: Your Atlassian account email
 - `JIRA_API_TOKEN`: Your Jira API token
 - `JIRA_BASE_URL`: Your Jira instance URL (e.g., `https://yourcompany.atlassian.net`)
@@ -91,12 +91,10 @@ Add the following to your Claude Desktop MCP settings file:
 {
   "mcpServers": {
     "jira": {
-      "name": "jira",
       "command": "node",
       "args": [
         "/absolute/path/to/jira-mcp-server/build/index.js"
       ],
-      "transport": "stdio",
       "env": {
         "JIRA_EMAIL": "your-email@company.com",
         "JIRA_API_TOKEN": "your-api-token-here",
@@ -115,130 +113,152 @@ Add the following to your Claude Desktop MCP settings file:
 4. Copy the generated token
 5. Use it in your configuration
 
+## Tool Architecture
+
+This server exposes **5 compound tools** — each with an `action` parameter that selects the operation. This design reduces the token overhead of tool definitions by ~50% compared to 16 flat tools, leaving more context for actual work.
+
+| Tool | Actions | Description |
+|------|---------|-------------|
+| `jira_issues` | `get` `create` `update` `assign` | Full issue lifecycle management |
+| `jira_search` | `issues` `projects` `users` `create_metadata` | Search and discovery |
+| `jira_comments` | `get` `add` | Read and write comments |
+| `jira_workflow` | `get_transitions` `transition` | Status transitions |
+| `jira_attachments` | `list` `get_content` `upload` `delete` | File attachments |
+
+---
+
 ## Available Tools
 
-### Issue Management
+### `jira_issues`
 
-#### `get_issue`
-Get detailed information about a Jira issue.
+Manage the full lifecycle of Jira issues.
 
-**Parameters**:
-- `issueKey` (required): The issue key (e.g., "PROJ-123")
+**Required**: `action`
 
-**Example**:
+| Action | Description | Required params | Optional params |
+|--------|-------------|-----------------|-----------------|
+| `get` | Fetch full issue details | `issueKey` | — |
+| `create` | Create a new issue | `projectKey`, `summary`, `issueType` | `description`, `priority`, `assignee`, `labels`, `customFields` |
+| `update` | Edit fields on an existing issue | `issueKey` | `summary`, `description`, `priority`, `assignee`, `labels`, `customFields` |
+| `assign` | Set or clear the assignee | `issueKey`, `assignee` | — |
+
+**Tips**:
+- Always call `jira_search` with `action=create_metadata` before creating issues to discover required custom fields and allowed values.
+- Pass `assignee: "-1"` to unassign an issue.
+- `description` accepts plain text or an [Atlassian Document Format (ADF)](https://developer.atlassian.com/cloud/jira/platform/apis/document/structure/) object.
+- `customFields` is a key-value map: `{"customfield_10000": "value"}`.
+
+**Examples**:
 ```
-Get details for issue PROJ-123
+Get details for PROJ-123
+Create a Bug in project PROJ with summary "Login button broken"
+Update PROJ-123 priority to High
+Assign PROJ-123 to john.doe@company.com
 ```
 
-#### `create_issue`
-Create a new Jira issue.
+---
 
-**Important**: Always use `get_create_metadata` first to discover required fields, custom fields, and allowed values.
+### `jira_search`
 
-**Parameters**:
-- `projectKey` (required): Project key (e.g., "PROJ", "DEV")
-- `summary` (required): Issue title
-- `issueType` (required): Type (e.g., "Bug", "Task", "Story")
-- `description` (optional): Issue description
-- `priority` (optional): Priority name
-- `assignee` (optional): Assignee account ID or email
-- `labels` (optional): Array of labels
-- `customFields` (optional): Custom fields object
+Search and discover Jira resources.
 
-**Example**:
-```
-Create a bug in project PROJ with summary "Login button not working" and description "Users cannot log in"
-```
+**Required**: `action`
 
-#### `update_issue`
-Update fields of an existing issue.
+| Action | Description | Required params | Optional params |
+|--------|-------------|-----------------|-----------------|
+| `issues` | Search issues via JQL | `jql` | `maxResults` |
+| `projects` | List all accessible projects | — | `maxResults` |
+| `users` | Find users by name or email | `query` | `maxResults` |
+| `create_metadata` | Get field requirements for creating issues | `projectKey` | `issueType` |
 
-**Tip**: Use `get_create_metadata` to discover available custom fields and their allowed values.
+**Common JQL examples**:
+```
+project = PROJ AND status = Open
+assignee = currentUser() AND status != Done
+priority = High AND created >= -7d
+```
 
-**Parameters**:
-- `issueKey` (required): Issue to update
-- `summary` (optional): New summary
-- `description` (optional): New description
-- `priority` (optional): New priority
-- `assignee` (optional): New assignee
-- `labels` (optional): New labels array
-- `customFields` (optional): Custom fields object
+**Tips**:
+- Use `create_metadata` before `jira_issues` `create` to understand what fields are required for a project/issue type.
+- Use `users` to look up account IDs for assignments — pass the returned account ID or email to `jira_issues` `assign`.
 
-#### `assign_issue`
-Assign an issue to a user.
+---
 
-**Parameters**:
-- `issueKey` (required): Issue to assign
-- `assignee` (required): User account ID, email, or "-1" to unassign
+### `jira_comments`
 
-### Metadata & Discovery
+Read and write comments on a Jira issue.
 
-#### `get_create_metadata`
-Get field requirements and metadata for creating issues in a project.
+**Required**: `action`, `issueKey`
 
-**Parameters**:
-- `projectKey` (required): Project key
-- `issueType` (optional): Filter by specific issue type
+| Action | Description | Required params |
+|--------|-------------|-----------------|
+| `get` | Fetch all comments on an issue | — |
+| `add` | Post a new comment | `comment` |
 
-#### `search_users`
-Search for users by name or email to get their account ID.
+`comment` accepts plain text or an ADF object.
 
-**Parameters**:
-- `query` (required): Search query (email or name)
-- `maxResults` (optional): Max results (default: 50)
+**Examples**:
+```
+Get all comments on PROJ-123
+Add a comment to PROJ-123: "Fixed in PR #456"
+```
 
-### Search
+---
 
-#### `search_issues`
-Search for issues using JQL. Returns issue keys and titles.
+### `jira_workflow`
 
-**Parameters**:
-- `jql` (required): JQL query string
-- `maxResults` (optional): Max results (default: 50)
+Manage issue status transitions.
 
-**Example JQL queries**:
-- `"project = PROJ AND status = Open"`
-- `"assignee = currentUser() AND status != Done"`
-- `"priority = High AND created >= -7d"`
+**Required**: `action`, `issueKey`
 
-#### `list_projects`
-List all accessible projects.
+| Action | Description | Required params | Optional params |
+|--------|-------------|-----------------|-----------------|
+| `get_transitions` | List available status transitions | — | — |
+| `transition` | Move issue to a new status | `transitionId` | `comment` |
 
-**Parameters**:
-- `maxResults` (optional): Max results (default: 50)
+**Tip**: Always call `get_transitions` first — transition IDs vary per project and issue type. The `transitionId` from the response is what you pass to `transition`.
 
-### Comments
+**Examples**:
+```
+Get available transitions for PROJ-123
+Move PROJ-123 to "In Progress" (use get_transitions first to find the ID)
+```
 
-#### `add_comment`
-Add a comment to an issue.
+---
 
-**Parameters**:
-- `issueKey` (required): Issue to comment on
-- `comment` (required): Comment text
+### `jira_attachments`
 
-#### `get_comments`
-Get all comments for an issue.
+Manage file attachments on Jira issues.
 
-**Parameters**:
-- `issueKey` (required): Issue key
+**Required**: `action`
 
-### Workflow Transitions
+| Action | Description | Required params | Optional params |
+|--------|-------------|-----------------|-----------------|
+| `list` | List all attachments with metadata | `issueKey` | — |
+| `get_content` | Download and return file content | `attachmentId` | `mimeType` |
+| `upload` | Attach a local file to an issue | `issueKey`, `filePath` | `fileName` |
+| `delete` | Remove an attachment by ID | `attachmentId` | — |
 
-#### `get_transitions`
-Get available status transitions for an issue.
+**Content types returned by `get_content`**:
+- **Text files** (`text/*`, `application/json`, `application/xml`): returned as readable text
+- **Images** (`image/*`): returned as base64 — Claude will render them inline
+- **Other types** (PDF, zip, etc.): returns file metadata with a descriptive message
 
-**Parameters**:
-- `issueKey` (required): Issue key
+**Tips**:
+- Use `list` first to get attachment IDs before calling `get_content` or `delete`.
+- `fileName` in `upload` overrides the filename shown in Jira (defaults to the file's basename).
 
-#### `transition_issue`
-Change the status of an issue.
+**Examples**:
+```
+List attachments on PROJ-123
+Get the content of attachment 136904
+Upload /tmp/report.pdf to PROJ-123
+Delete attachment 136904
+```
 
-**Parameters**:
-- `issueKey` (required): Issue to transition
-- `transitionId` (required): Transition ID (from get_transitions)
-- `comment` (optional): Comment to add with transition
+---
 
-### API Reference
+## API Reference
 
 This server uses the [Jira REST API v3](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/).
 
@@ -252,7 +272,7 @@ Make sure you've set the environment variables in your MCP configuration.
 
 - Verify your API token is correct
 - Ensure your email matches your Atlassian account
-- Check that your JIRA_BASE_URL doesn't have a trailing slash
+- Check that your `JIRA_BASE_URL` doesn't have a trailing slash
 
 ### Permission errors
 

package/build/handlers/attachment-handlers.d.ts

@@ -0,0 +1,65 @@
+import { JiraApiClient } from '../utils/api-client.js';
+export declare class AttachmentHandlers {
+    private apiClient;
+    constructor(apiClient: JiraApiClient);
+    handleListAttachments(args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+    handleGetAttachmentContent(args: any): Promise<{
+        content: ({
+            type: string;
+            text: string;
+            data?: undefined;
+            mimeType?: undefined;
+        } | {
+            type: string;
+            data: string;
+            mimeType: string;
+            text?: undefined;
+        })[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+    handleUploadAttachment(args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+    handleDeleteAttachment(args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+}
+//# sourceMappingURL=attachment-handlers.d.ts.map

package/build/handlers/attachment-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/attachment-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,qBAAa,kBAAkB;IACjB,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAEtC,qBAAqB,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;IAgC/B,0BAA0B,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;IAsEpC,sBAAsB,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;IAwChC,sBAAsB,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;CAqCvC"}

package/build/handlers/attachment-handlers.js

@@ -0,0 +1,176 @@
+import { existsSync } from 'fs';
+import { basename } from 'path';
+import { JiraFormatters } from '../utils/formatters.js';
+export class AttachmentHandlers {
+    apiClient;
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    async handleListAttachments(args) {
+        try {
+            const { issueKey } = args;
+            if (!issueKey) {
+                throw new Error('issueKey is required');
+            }
+            const issue = await this.apiClient.get(`/issue/${issueKey}`, { fields: 'attachment' });
+            const attachments = issue.fields?.attachment || [];
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JiraFormatters.formatAttachments(attachments),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JiraFormatters.formatError(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    async handleGetAttachmentContent(args) {
+        try {
+            const { attachmentId } = args;
+            if (!attachmentId) {
+                throw new Error('attachmentId is required');
+            }
+            // Fetch metadata to get filename and MIME type
+            const metadata = await this.apiClient.get(`/attachment/${attachmentId}`);
+            const filename = metadata.filename || 'unknown';
+            const mimeType = args.mimeType || metadata.mimeType || 'application/octet-stream';
+            const sizeBytes = metadata.size || 0;
+            const sizeKB = (sizeBytes / 1024).toFixed(1);
+            // Download the actual file bytes
+            const { data, contentType } = await this.apiClient.downloadAttachment(attachmentId);
+            const effectiveMime = contentType.split(';')[0].trim() || mimeType;
+            if (effectiveMime.startsWith('text/') || effectiveMime === 'application/json' || effectiveMime === 'application/xml') {
+                const text = data.toString('utf-8');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `**Attachment**: ${filename} (${effectiveMime}, ${sizeKB} KB)\n\n${text}`,
+                        },
+                    ],
+                };
+            }
+            if (effectiveMime.startsWith('image/')) {
+                const base64String = data.toString('base64');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `**Attachment**: ${filename} (${effectiveMime}, ${sizeKB} KB)`,
+                        },
+                        {
+                            type: 'image',
+                            data: base64String,
+                            mimeType: effectiveMime,
+                        },
+                    ],
+                };
+            }
+            // Unsupported type (PDF, zip, etc.)
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `**Attachment**: ${filename}\n**Type**: ${effectiveMime}\n**Size**: ${sizeKB} KB\n\nThis attachment cannot be displayed as text or image. Download it directly from Jira.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JiraFormatters.formatError(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    async handleUploadAttachment(args) {
+        try {
+            const { issueKey, filePath, fileName } = args;
+            if (!issueKey) {
+                throw new Error('issueKey is required');
+            }
+            if (!filePath) {
+                throw new Error('filePath is required');
+            }
+            if (!existsSync(filePath)) {
+                throw new Error(`File not found: ${filePath}`);
+            }
+            const name = fileName || basename(filePath);
+            const result = await this.apiClient.uploadAttachment(issueKey, filePath, name);
+            const attachment = result[0];
+            const sizeKB = attachment.size ? (attachment.size / 1024).toFixed(1) : 'unknown';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Attachment uploaded successfully to ${issueKey}.\n\n**ID**: ${attachment.id}\n**Filename**: ${attachment.filename}\n**Size**: ${sizeKB} KB\n**MIME type**: ${attachment.mimeType || 'unknown'}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JiraFormatters.formatError(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    async handleDeleteAttachment(args) {
+        try {
+            const { attachmentId } = args;
+            if (!attachmentId) {
+                throw new Error('attachmentId is required');
+            }
+            try {
+                await this.apiClient.delete(`/attachment/${attachmentId}`);
+            }
+            catch (err) {
+                if (err.message?.includes('(404)')) {
+                    throw new Error(`Attachment not found: ${attachmentId}`);
+                }
+                throw err;
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Attachment ${attachmentId} deleted successfully.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JiraFormatters.formatError(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+}
+//# sourceMappingURL=attachment-handlers.js.map

package/build/handlers/attachment-handlers.js.map

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

package/build/index.js

@@ -10,6 +10,7 @@ import { TransitionHandlers } from './handlers/transition-handlers.js';
 import { ProjectHandlers } from './handlers/project-handlers.js';
 import { MetadataHandlers } from './handlers/metadata-handlers.js';
 import { UserHandlers } from './handlers/user-handlers.js';
+import { AttachmentHandlers } from './handlers/attachment-handlers.js';
 import { toolDefinitions } from './tools/definitions.js';
 // Get environment variables
 const JIRA_EMAIL = process.env.JIRA_EMAIL;
@@ -36,6 +37,7 @@ class JiraMCPServer {
     projectHandlers;
     metadataHandlers;
     userHandlers;
+    attachmentHandlers;
     constructor() {
         this.server = new Server({
             name: 'jira-mcp-server',
@@ -55,6 +57,7 @@ class JiraMCPServer {
         this.transitionHandlers = new TransitionHandlers(this.apiClient);
         this.projectHandlers = new ProjectHandlers(this.apiClient);
         this.metadataHandlers = new MetadataHandlers(this.apiClient);
+        this.attachmentHandlers = new AttachmentHandlers(this.apiClient);
         this.setupToolHandlers();
         // Error handling
         this.server.onerror = (error) => console.error('[MCP Error]', error);
@@ -71,36 +74,52 @@ class JiraMCPServer {
         // Handle tool calls
         this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
             switch (request.params.name) {
-                // Issue Management tools
-                case 'get_issue':
-                    return this.issueHandlers.handleGetIssue(request.params.arguments);
-                case 'create_issue':
-                    return this.issueHandlers.handleCreateIssue(request.params.arguments);
-                case 'update_issue':
-                    return this.issueHandlers.handleUpdateIssue(request.params.arguments);
-                case 'assign_issue':
-                    return this.issueHandlers.handleAssignIssue(request.params.arguments);
-                // Search tools
-                case 'search_issues':
-                    return this.searchHandlers.handleSearchIssues(request.params.arguments);
-                case 'list_projects':
-                    return this.projectHandlers.handleListProjects(request.params.arguments);
-                // Metadata tools
-                case 'get_create_metadata':
-                    return this.metadataHandlers.handleGetCreateMetadata(request.params.arguments);
-                // User tools
-                case 'search_users':
-                    return this.userHandlers.handleSearchUsers(request.params.arguments);
-                // Comment tools
-                case 'add_comment':
-                    return this.commentHandlers.handleAddComment(request.params.arguments);
-                case 'get_comments':
-                    return this.commentHandlers.handleGetComments(request.params.arguments);
-                // Transition tools
-                case 'get_transitions':
-                    return this.transitionHandlers.handleGetTransitions(request.params.arguments);
-                case 'transition_issue':
-                    return this.transitionHandlers.handleTransitionIssue(request.params.arguments);
+                case 'jira_issues': {
+                    const args = request.params.arguments;
+                    switch (args.action) {
+                        case 'get': return this.issueHandlers.handleGetIssue(args);
+                        case 'create': return this.issueHandlers.handleCreateIssue(args);
+                        case 'update': return this.issueHandlers.handleUpdateIssue(args);
+                        case 'assign': return this.issueHandlers.handleAssignIssue(args);
+                        default: throw new McpError(ErrorCode.InvalidParams, `Unknown action: ${args.action}`);
+                    }
+                }
+                case 'jira_search': {
+                    const args = request.params.arguments;
+                    switch (args.action) {
+                        case 'issues': return this.searchHandlers.handleSearchIssues(args);
+                        case 'projects': return this.projectHandlers.handleListProjects(args);
+                        case 'users': return this.userHandlers.handleSearchUsers(args);
+                        case 'create_metadata': return this.metadataHandlers.handleGetCreateMetadata(args);
+                        default: throw new McpError(ErrorCode.InvalidParams, `Unknown action: ${args.action}`);
+                    }
+                }
+                case 'jira_comments': {
+                    const args = request.params.arguments;
+                    switch (args.action) {
+                        case 'get': return this.commentHandlers.handleGetComments(args);
+                        case 'add': return this.commentHandlers.handleAddComment(args);
+                        default: throw new McpError(ErrorCode.InvalidParams, `Unknown action: ${args.action}`);
+                    }
+                }
+                case 'jira_workflow': {
+                    const args = request.params.arguments;
+                    switch (args.action) {
+                        case 'get_transitions': return this.transitionHandlers.handleGetTransitions(args);
+                        case 'transition': return this.transitionHandlers.handleTransitionIssue(args);
+                        default: throw new McpError(ErrorCode.InvalidParams, `Unknown action: ${args.action}`);
+                    }
+                }
+                case 'jira_attachments': {
+                    const args = request.params.arguments;
+                    switch (args.action) {
+                        case 'list': return this.attachmentHandlers.handleListAttachments(args);
+                        case 'get_content': return this.attachmentHandlers.handleGetAttachmentContent(args);
+                        case 'upload': return this.attachmentHandlers.handleUploadAttachment(args);
+                        case 'delete': return this.attachmentHandlers.handleDeleteAttachment(args);
+                        default: throw new McpError(ErrorCode.InvalidParams, `Unknown action: ${args.action}`);
+                    }
+                }
                 default:
                     throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${request.params.name}`);
             }