@vitalyostanin/youtrack-mcp 0.6.0 → 0.7.0

package/README-ru.md

@@ -36,6 +36,7 @@ MCP сервер для полноценной интеграции с YouTrack
 - [Инструменты MCP](#инструменты-mcp)
   - [Сервис](#сервис)
   - [Задачи](#задачи)
+  - [Связи задач](#связи-задач)
   - [Звездочки задач](#звездочки-задач)
   - [Трудозатраты](#трудозатраты)
   - [Пользователи и проекты](#пользователи-и-проекты)
@@ -289,6 +290,15 @@ YOUTRACK_TOKEN = "perm:your-token-here"
 | `issue_change_state` | Изменение состояния/статуса задачи через переходы workflow. **Использование:** Перемещение задач через состояния рабочего процесса (например, 'Открыта' → 'В работе'). Автоматически определяет доступные переходы и валидирует запрошенное изменение состояния. Регистронезависимое сопоставление имён состояний. **Возвращает:** информацию о предыдущем состоянии, новом состоянии и использованном переходе | `issueId` — код задачи, `stateName` — имя целевого состояния (например, 'В работе', 'Открыта', 'Исправлена', 'Проверена'). Регистронезависимое |
 | `issue_search_by_user_activity` | Поиск задач по активности пользователей в заданный период. **Использование:** Поиск задач, где пользователи обновляли, были упомянуты, создавали, были назначены или комментировали. Поддерживает два режима фильтрации: `issue_updated` (по умолчанию, быстрый) использует поле issue.updated, `user_activity` (медленный, точный) проверяет фактические даты активности пользователя, включая комментарии, упоминания и историю изменений полей. **Когда использовать точный режим:** когда нужна точная дата участия пользователя (например, когда пользователь был исполнителем, но позже был изменён). **Возвращает:** краткую информацию о задачах (id, idReadable, summary, project, parent, assignee) без description для уменьшения размера ответа. В режиме `user_activity` включает поле `lastActivityDate` с точной датой последней активности пользователя. Результаты отсортированы по времени активности (новые первыми). Поддерживает пагинацию. **Ограничение:** по умолчанию 100 задач, макс 200 | `userLogins[]` — массив логинов пользователей для поиска активности (updater, mentions, reporter, assignee, commenter), опционально `startDate` (формат YYYY-MM-DD или timestamp), `endDate`, `dateFilterMode` (`issue_updated` или `user_activity`), `limit` (по умолчанию 100, макс 200), `skip` для пагинации |
 
+### Связи задач
+
+| Tool | Описание | Основные параметры |
+| --- | --- | --- |
+| `issue_links` | Список связей (линков) для задачи: «relates to», «duplicate», «parent/child». Возвращает id связи, направление (inward/outward), тип связи и краткую информацию о связанной задаче | `issueId` — код задачи |
+| `issue_link_types` | Список доступных типов связей в YouTrack. Полезно для подбора корректного типа при создании связи | — |
+| `issue_link_add` | Создание связи между двумя задачами | `sourceId` — исходная задача, `targetId` — целевая задача, `linkType` — имя или id типа связи (например, `Relates` или UUID) |
+| `issue_link_delete` | Удаление существующей связи по её id для указанной задачи | `issueId` — код задачи, `linkId` — id связи |
+
 ### Звездочки задач
 
 | Tool | Описание | Основные параметры |

package/README.md

@@ -38,6 +38,7 @@ MCP server for comprehensive YouTrack integration with the following capabilitie
 - [MCP Tools](#mcp-tools)
   - [Service](#service)
   - [Issues](#issues)
+  - [Issue Links](#issue-links)
   - [Issue Stars](#issue-stars)
   - [Work Items](#work-items)
   - [Users and Projects](#users-and-projects)
@@ -295,6 +296,15 @@ Tools return either `structuredContent` (default) or a text `content` item, depe
 | `issue_attachment_upload` | Upload files to issue | `issueId`, `filePaths[]` — array of file paths (max 10), optionally `muteUpdateNotifications` |
 | `issue_attachment_delete` | Delete attachment (requires confirmation) | `issueId`, `attachmentId`, `confirmation` (must be `true`) |
 
+### Issue Links
+
+| Tool | Description | Main Parameters |
+| --- | --- | --- |
+| `issue_links` | List links for an issue (relates to, duplicate, parent/child). Returns link id, direction, linkType, and counterpart issue brief | `issueId` — issue code |
+| `issue_link_types` | List available link types | — |
+| `issue_link_add` | Create a link between two issues | `sourceId`, `targetId`, `linkType` (name or id) |
+| `issue_link_delete` | Delete a link by id for a specific issue | `issueId`, `linkId` |
+
 ### Issue Stars
 
 | Tool | Description | Main Parameters |

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vitalyostanin/youtrack-mcp",
-    "version": "0.6.0",
+    "version": "0.7.0",
     "scripts": {
         "build": "tsc -p tsconfig.json",
         "postbuild": "chmod +x dist/index.js",

package/dist/src/server.js

@@ -11,6 +11,7 @@ import { registerUserTools } from "./tools/user-tools.js";
 import { registerProjectTools } from "./tools/project-tools.js";
 import { registerAttachmentTools } from "./tools/attachment-tools.js";
 import { registerIssueStarTools } from "./tools/issue-star-tools.js";
+import { registerIssueLinkTools } from "./tools/issue-link-tools.js";
 import { YoutrackClient } from "./youtrack-client.js";
 import { loadConfig } from "./config.js";
 import { initializeTimezone } from "./utils/date.js";
@@ -47,6 +48,7 @@ export class YoutrackServer {
         registerProjectTools(this.server, this.client);
         registerAttachmentTools(this.server, this.client);
         registerIssueStarTools(this.server, this.client);
+        registerIssueLinkTools(this.server, this.client);
     }
     async connect(transport) {
         await this.server.connect(transport);

package/dist/src/tools/issue-link-tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { YoutrackClient } from "../youtrack-client.js";
+export declare function registerIssueLinkTools(server: McpServer, client: YoutrackClient): void;
+//# sourceMappingURL=issue-link-tools.d.ts.map

package/dist/src/tools/issue-link-tools.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { toolError, toolSuccess } from "../utils/tool-response.js";
+const issueIdArgs = {
+    issueId: z.string().min(1).describe("Issue code (e.g., PROJ-123)"),
+};
+const issueIdSchema = z.object(issueIdArgs);
+const linkCreateArgs = {
+    sourceId: z.string().min(1).describe("Source issue code (e.g., PROJ-123)"),
+    targetId: z.string().min(1).describe("Target issue code (e.g., PROJ-456)"),
+    linkType: z
+        .string()
+        .min(1)
+        .describe("Link type name or id (e.g., 'Relates', 'Duplicate', or a type id)"),
+};
+const linkCreateSchema = z.object(linkCreateArgs);
+const linkDeleteArgs = {
+    issueId: z.string().min(1).describe("Issue code that holds the link (e.g., PROJ-123)"),
+    linkId: z.string().min(1).describe("Issue link id (internal youtrack id)"),
+};
+const linkDeleteSchema = z.object(linkDeleteArgs);
+export function registerIssueLinkTools(server, client) {
+    server.tool("issue_links", "List issue links for a given YouTrack issue. Use for: inspecting relationships like 'relates to', 'duplicates', 'parent/child'. Response includes link id, direction, linkType, and counterpart issue brief (idReadable, summary, project, assignee).", issueIdArgs, async (rawInput) => {
+        try {
+            const payload = issueIdSchema.parse(rawInput);
+            const result = await client.getIssueLinks(payload.issueId);
+            return toolSuccess(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    server.tool("issue_link_types", "List available YouTrack issue link types. Use for: discovering valid type names for creating links (e.g., 'Relates', 'Duplicate').", {}, async () => {
+        try {
+            const result = await client.listLinkTypes();
+            return toolSuccess(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    server.tool("issue_link_add", "Create a link between two issues. Provide sourceId, targetId and linkType (name or id). Limitations: link type must exist in project context; API may reject invalid combinations.", linkCreateArgs, async (rawInput) => {
+        try {
+            const input = linkCreateSchema.parse(rawInput);
+            const result = await client.addIssueLink(input);
+            return toolSuccess(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    server.tool("issue_link_delete", "Delete an existing issue link by id for a given issue. Use 'issue_links' to discover link ids first.", linkDeleteArgs, async (rawInput) => {
+        try {
+            const input = linkDeleteSchema.parse(rawInput);
+            const result = await client.deleteIssueLink(input);
+            return toolSuccess(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+}
+//# sourceMappingURL=issue-link-tools.js.map

package/dist/src/types.d.ts

@@ -385,6 +385,57 @@ export interface IssuesCommentsPayload {
     commentsByIssue: Record<string, MappedYoutrackIssueComment[]>;
     errors?: IssueError[];
 }
+export interface YoutrackIssueLinkType {
+    id: string;
+    name: string;
+    directed?: boolean;
+    outwardName?: string;
+    inwardName?: string;
+}
+export type YoutrackIssueLinkDirection = string;
+export interface YoutrackIssueLink {
+    id: string;
+    direction: YoutrackIssueLinkDirection;
+    linkType: YoutrackIssueLinkType;
+    source: {
+        idReadable: string;
+    };
+    issue: {
+        idReadable: string;
+        summary?: string;
+        project?: {
+            id: string;
+            shortName: string;
+            name?: string;
+        };
+        assignee?: YoutrackUser | null;
+    };
+}
+export type MappedYoutrackIssueLink = YoutrackIssueLink;
+export interface IssueLinksPayload {
+    issueId: string;
+    links: MappedYoutrackIssueLink[];
+}
+export interface IssueLinkTypesPayload {
+    types: YoutrackIssueLinkType[];
+}
+export interface IssueLinkCreateInput {
+    sourceId: string;
+    targetId: string;
+    linkType: string;
+}
+export interface IssueLinkCreatePayload {
+    link: MappedYoutrackIssueLink;
+}
+export interface IssueLinkDeleteInput {
+    issueId: string;
+    linkId: string;
+}
+export interface IssueLinkDeletePayload {
+    issueId: string;
+    linkId: string;
+    deleted: true;
+}
 export interface YoutrackAttachment {
     id: string;
     name: string;

package/dist/src/youtrack-client.d.ts

@@ -1,5 +1,5 @@
 import { type MappedYoutrackIssueComment, type MappedYoutrackWorkItem } from "./utils/mappers.js";
-import type { ArticleCreateInput, ArticleListPayload, ArticlePayload, ArticleSearchInput, ArticleSearchPayload, ArticleUpdateInput, AttachmentDeleteInput, AttachmentDeletePayload, AttachmentDownloadPayload, AttachmentPayload, AttachmentsListPayload, AttachmentUploadInput, AttachmentUploadPayload, IssueChangeStateInput, IssueChangeStatePayload, IssueCommentsPayload, IssueCommentCreateInput, IssueCommentUpdateInput, IssueCommentUpdatePayload, IssueDetailsPayload, IssueLookupPayload, IssueSearchInput, IssueSearchPayload, IssuesCommentsPayload, IssuesDetailsPayload, IssuesLookupPayload, IssueStarBatchPayload, IssueStarPayload, IssuesStarredPayload, WorkItemBulkResultPayload, WorkItemDeletePayload, WorkItemInvalidDay, WorkItemReportPayload, WorkItemUsersReportPayload, YoutrackActivityItem, YoutrackConfig, YoutrackCustomField, YoutrackIssueAssignInput, YoutrackIssueComment, YoutrackIssueCreateInput, YoutrackIssueDetails, YoutrackIssueUpdateInput, YoutrackProject, YoutrackProjectListPayload, YoutrackUser, YoutrackUserListPayload, YoutrackWorkItem, YoutrackWorkItemCreateInput, YoutrackWorkItemIdempotentCreateInput, YoutrackWorkItemPeriodCreateInput, YoutrackWorkItemReportOptions, YoutrackWorkItemUpdateInput } from "./types.js";
+import type { ArticleCreateInput, ArticleListPayload, ArticlePayload, ArticleSearchInput, ArticleSearchPayload, ArticleUpdateInput, AttachmentDeleteInput, AttachmentDeletePayload, AttachmentDownloadPayload, AttachmentPayload, AttachmentsListPayload, AttachmentUploadInput, AttachmentUploadPayload, IssueChangeStateInput, IssueChangeStatePayload, IssueCommentsPayload, IssueCommentCreateInput, IssueCommentUpdateInput, IssueCommentUpdatePayload, IssueDetailsPayload, IssueLookupPayload, IssueSearchInput, IssueSearchPayload, IssuesCommentsPayload, IssuesDetailsPayload, IssuesLookupPayload, IssueStarBatchPayload, IssueStarPayload, IssuesStarredPayload, IssueLinksPayload, IssueLinkTypesPayload, IssueLinkCreateInput, IssueLinkCreatePayload, IssueLinkDeleteInput, IssueLinkDeletePayload, WorkItemBulkResultPayload, WorkItemDeletePayload, WorkItemInvalidDay, WorkItemReportPayload, WorkItemUsersReportPayload, YoutrackActivityItem, YoutrackConfig, YoutrackCustomField, YoutrackIssueAssignInput, YoutrackIssueComment, YoutrackIssueCreateInput, YoutrackIssueDetails, YoutrackIssueUpdateInput, YoutrackProject, YoutrackProjectListPayload, YoutrackUser, YoutrackUserListPayload, YoutrackWorkItem, YoutrackWorkItemCreateInput, YoutrackWorkItemIdempotentCreateInput, YoutrackWorkItemPeriodCreateInput, YoutrackWorkItemReportOptions, YoutrackWorkItemUpdateInput } from "./types.js";
 export declare class YoutrackClient {
     private readonly config;
     private readonly http;
@@ -12,6 +12,11 @@ export declare class YoutrackClient {
      * Returns only `data` for convenience.
      */
     private getWithFlexibleTop;
+    getIssueLinks(issueId: string): Promise<IssueLinksPayload>;
+    listLinkTypes(): Promise<IssueLinkTypesPayload>;
+    addIssueLink(input: IssueLinkCreateInput): Promise<IssueLinkCreatePayload>;
+    deleteIssueLink(input: IssueLinkDeleteInput): Promise<IssueLinkDeletePayload>;
+    private mapIssueLinkRow;
     /**
      * Process items with concurrency limit using MutexPool
      * @param items - Array of items to process

package/dist/src/youtrack-client.js

@@ -68,6 +68,9 @@ const defaultFields = {
     articleList: "id,idReadable,summary,parentArticle(id,idReadable),project(id,shortName,name)",
     attachment: "id,name,author(id,login,name),created,updated,size,mimeType,url,thumbnailURL,extension",
     attachments: "id,name,author(id,login,name),created,updated,size,mimeType,extension",
+    // Links
+    issueLinks: "id,direction,linkType(id,name,directed,outwardName,inwardName),issues(idReadable,summary,project(id,shortName,name),assignee(id,login,name))",
+    linkTypes: "id,name,directed,outwardName,inwardName",
 };
 class YoutrackClientError extends Error {
     status;
@@ -141,6 +144,85 @@ export class YoutrackClient {
             throw error;
         }
     }
+    // =========================
+    // Issue Links API
+    // =========================
+    async getIssueLinks(issueId) {
+        try {
+            const response = await this.http.get(`/api/issues/${issueId}/links`, {
+                params: { fields: defaultFields.issueLinks },
+            });
+            const links = response.data
+                .flatMap((row) => this.mapIssueLinkRow(issueId, row))
+                // filter out entries that point back to the same issue or have no counterpart
+                .filter((l) => l.issue.idReadable && l.issue.idReadable !== issueId);
+            const payload = { issueId, links };
+            return payload;
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
+    async listLinkTypes() {
+        try {
+            const response = await this.http.get("/api/issueLinkTypes", {
+                params: { fields: defaultFields.linkTypes },
+            });
+            const payload = { types: response.data };
+            return payload;
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
+    async addIssueLink(input) {
+        const body = {
+            linkType: /[a-f0-9-]{8,}/i.test(input.linkType) ? { id: input.linkType } : { name: input.linkType },
+            issues: [{ idReadable: input.targetId }],
+        };
+        try {
+            const response = await this.http.post(`/api/issues/${input.sourceId}/links`, body, {
+                params: { fields: defaultFields.issueLinks },
+            });
+            const variants = this.mapIssueLinkRow(input.sourceId, response.data);
+            const mapped = variants.find((v) => v.issue.idReadable === input.targetId) ?? variants[0];
+            const payload = { link: mapped };
+            return payload;
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
+    async deleteIssueLink(input) {
+        try {
+            await this.http.delete(`/api/issues/${input.issueId}/links/${input.linkId}`);
+            return { issueId: input.issueId, linkId: input.linkId, deleted: true };
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
+    mapIssueLinkRow(currentIssueId, row) {
+        const issues = row.issues ?? [];
+        const source = issues.find((i) => i.idReadable === currentIssueId) ?? { idReadable: currentIssueId };
+        const counterparts = issues.filter((i) => i.idReadable !== currentIssueId);
+        if (counterparts.length === 0) {
+            // No concrete counterpart provided by API for this row; return an empty array
+            return [];
+        }
+        return counterparts.map((counterpart) => ({
+            id: row.id,
+            direction: row.direction ?? (source.idReadable === currentIssueId ? "outward" : "inward"),
+            linkType: row.linkType,
+            source: { idReadable: source.idReadable },
+            issue: {
+                idReadable: counterpart.idReadable,
+                summary: counterpart.summary,
+                project: counterpart.project,
+                assignee: counterpart.assignee ?? null,
+            },
+        }));
+    }
     /**
      * Process items with concurrency limit using MutexPool
      * @param items - Array of items to process

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitalyostanin/youtrack-mcp",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "postbuild": "chmod +x dist/index.js",