org-jira-mcp-adapter 1.0.0

package/README.md

@@ -0,0 +1,37 @@
+# Jira MCP Adapter
+
+Этот пакет предоставляет MCP сервер для работы с Jira (Server / Data Center), адаптированный для вашей команды.
+
+## Как использовать (для команды)
+
+Вам не нужно ничего устанавливать или клонировать репозиторий.
+Просто добавьте следующую конфигурацию в настройки MCP вашей IDE (Trae, Cursor, VSCode).
+
+### Конфигурация (JSON)
+
+Вставьте этот блок в `mcpServers` в вашем конфигурационном файле (обычно открывается через настройки IDE -> "Edit MCP Settings"):
+
+```json
+{
+  "mcpServers": {
+    "jira": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "org-jira-mcp-adapter"
+      ],
+      "env": {
+        "JIRA_HOST": "jira.example.com",
+        "JIRA_API_TOKEN": "your_password_or_pat_token"
+      }
+    }
+  }
+}
+```
+
+> **Важно**: Замените `jira.example.com` и `your_password_or_pat_token` на ваши реальные данные.
+
+### Переменные окружения
+
+- `JIRA_HOST`: Адрес вашего Jira сервера (без протокола, например `jira.example.com`).
+- `JIRA_API_TOKEN`: Ваш пароль от Jira или Personal Access Token (PAT).

package/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { connectServer, createMcpServer, formatToolResponse } from '@atlassian-dc-mcp/common';
+import { JiraService, jiraToolSchemas } from './jira-service.js';
+import * as process from 'node:process';
+
+const missingEnvVars = JiraService.validateConfig();
+
+if (missingEnvVars.length > 0) {
+    throw new Error(`Missing required environment variables: ${missingEnvVars.join(', ')}`);
+}
+
+// Removing email from constructor as it is not needed for PAT auth
+const jiraService = new JiraService(process.env.JIRA_HOST, process.env.JIRA_API_TOKEN, process.env.JIRA_API_BASE_PATH);
+
+const server = createMcpServer({
+    name: "atlassian-jira-mcp",
+    version: "0.1.0"
+});
+
+const jiraInstanceType = "JIRA Data Center edition instance";
+
+server.tool("jira_searchIssues", `Search for JIRA issues using JQL in the ${jiraInstanceType}`, jiraToolSchemas.searchIssues, async ({ jql, expand, startAt, maxResults = 10 }) => {
+    const result = await jiraService.searchIssues(jql, startAt, expand, maxResults);
+    return formatToolResponse(result);
+});
+
+server.tool("jira_getIssue", `Get details of a JIRA issue by its key from the ${jiraInstanceType}`, jiraToolSchemas.getIssue, async ({ issueKey, expand }) => {
+    const result = await jiraService.getIssue(issueKey, expand);
+    return formatToolResponse(result);
+});
+
+server.tool('jira_getIssueComments', `Get comments of a JIRA issue by its key from the ${jiraInstanceType}`, jiraToolSchemas.getIssueComments, async ({ issueKey, expand }) => {
+    const result = await jiraService.getIssueComments(issueKey, expand);
+    return formatToolResponse(result);
+});
+
+server.tool("jira_createIssue", `Create a new JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.createIssue, async (params) => {
+    const result = await jiraService.createIssue(params);
+    return formatToolResponse(result);
+});
+
+server.tool("jira_updateIssue", `Update an existing JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.updateIssue, async (params) => {
+    const result = await jiraService.updateIssue(params);
+    return formatToolResponse(result);
+});
+
+server.tool("jira_postIssueComment", `Post a comment on a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.postIssueComment, async ({ issueKey, comment }) => {
+    const result = await jiraService.postIssueComment(issueKey, comment);
+    return formatToolResponse(result);
+});
+
+await connectServer(server);

package/jira-service.js

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+import { handleApiOperation } from '@atlassian-dc-mcp/common';
+import { IssueService, OpenAPI, SearchService } from '@atlassian-dc-mcp/jira/build/jira-client/index.js';
+
+export class JiraService {
+    constructor(host, token, fullBaseUrl, email) {
+        if (fullBaseUrl) {
+            OpenAPI.BASE = fullBaseUrl;
+        } else if (host) {
+            const cleanHost = host.replace(/^https?:\/\//, '').replace(/\/$/, '');
+            OpenAPI.BASE = `https://${cleanHost}/rest`;
+        }
+        if (email) {
+            OpenAPI.USERNAME = email;
+            OpenAPI.PASSWORD = token;
+        } else {
+            OpenAPI.TOKEN = token;
+        }
+        OpenAPI.VERSION = '2';
+    }
+
+    async searchIssues(jql, startAt, expand, maxResults = 10) {
+        return handleApiOperation(() => {
+            return SearchService.searchUsingSearchRequest({
+                jql,
+                maxResults,
+                expand,
+                startAt
+            });
+        }, 'Error searching issues');
+    }
+
+    async getIssue(issueKey, expand) {
+        return handleApiOperation(() => IssueService.getIssue(issueKey, expand), 'Error getting issue');
+    }
+
+    async getIssueComments(issueKey, expand) {
+        return handleApiOperation(() => IssueService.getComments(issueKey, expand), 'Error getting issue comments');
+    }
+
+    async postIssueComment(issueKey, comment) {
+        return handleApiOperation(() => IssueService.addComment(issueKey, undefined, { body: comment }), 'Error posting issue comment');
+    }
+
+    async createIssue(params) {
+        return handleApiOperation(async () => {
+            const standardFields = {
+                project: { key: params.projectId },
+                summary: params.summary,
+                description: params.description,
+                issuetype: { id: params.issueTypeId }
+            };
+
+            const fields = params.customFields
+                ? { ...standardFields, ...params.customFields }
+                : standardFields;
+
+            return IssueService.createIssue(true, { fields });
+        }, 'Error creating issue');
+    }
+
+    async updateIssue(params) {
+        return handleApiOperation(async () => {
+            const standardFields = {};
+            if (params.summary !== undefined) {
+                standardFields.summary = params.summary;
+            }
+            if (params.description !== undefined) {
+                standardFields.description = params.description;
+            }
+            if (params.issueTypeId !== undefined) {
+                standardFields.issuetype = { id: params.issueTypeId };
+            }
+
+            const fields = params.customFields
+                ? { ...standardFields, ...params.customFields }
+                : standardFields;
+
+            return IssueService.editIssue(params.issueKey, 'true', { fields });
+        }, 'Error updating issue');
+    }
+
+    static validateConfig() {
+        const requiredEnvVars = ['JIRA_API_TOKEN'];
+        const missingVars = requiredEnvVars.filter(varName => !process.env[varName]);
+        
+        if (!process.env.JIRA_HOST && !process.env.JIRA_API_BASE_PATH) {
+            missingVars.push('JIRA_HOST or JIRA_API_BASE_PATH');
+        }
+
+        return missingVars;
+    }
+}
+
+export const jiraToolSchemas = {
+    searchIssues: {
+        jql: z.string().describe("JQL query string"),
+        maxResults: z.number().optional().describe("Maximum number of results to return"),
+        startAt: z.number().optional().describe("Index of the first result to return"),
+        expand: z.array(z.string()).optional().describe("Fields to expand")
+    },
+    getIssue: {
+        issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
+        expand: z.string().optional().describe("Comma separated fields to expand")
+    },
+    getIssueComments: {
+        issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
+        expand: z.string().optional().describe("Comma separated fields to expand")
+    },
+    postIssueComment: {
+        issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
+        comment: z.string().describe("Comment text in the format suitable for JIRA DATA CENTER edition (JIRA Wiki Markup).")
+    },
+    createIssue: {
+        projectId: z.string().describe("Project id"),
+        summary: z.string().describe("Issue summary"),
+        description: z.string().describe("Issue description in the format suitable for JIRA DATA CENTER edition (JIRA Wiki Markup)."),
+        issueTypeId: z.string().describe("Issue type id (e.g. id of Task, Bug, Story). Should be found first a correct number for specific JIRA installation."),
+        customFields: z.object({}).catchall(z.any()).optional().describe("Optional custom fields as key-value pairs. Examples: {'customfield_10001': 'Custom Value', 'priority': {'id': '1'}, 'assignee': {'name': 'john.doe'}, 'labels': ['urgent', 'bug']}")
+    },
+    updateIssue: {
+        issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
+        summary: z.string().optional().describe("New summary (optional)"),
+        description: z.string().optional().describe("New description in JIRA Wiki Markup (optional)"),
+        issueTypeId: z.string().optional().describe("New issue type id (optional)"),
+        customFields: z.object({}).catchall(z.any()).optional().describe("Optional custom fields to update as key-value pairs. Examples: {'customfield_10001': 'Custom Value', 'priority': {'id': '1'}, 'assignee': {'name': 'john.doe'}, 'labels': ['urgent', 'bug']}")
+    }
+};

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "org-jira-mcp-adapter",
+  "version": "1.0.0",
+  "description": "MCP server for Jira Data Center/Server (On-Premise)",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "org-jira-mcp-adapter": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "dependencies": {
+    "@atlassian-dc-mcp/common": "^0.9.9",
+    "@atlassian-dc-mcp/jira": "^0.9.9",
+    "zod": "^4.2.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "jira",
+    "atlassian",
+    "server",
+    "data-center"
+  ],
+  "author": "",
+  "license": "ISC"
+}