YouTrack MCP服务器

也有俄语版本： README-ru.md

![CI](https://github.com/VitalyOstanin/youtrack-mcp/actions/workflows/ci.yml) ![codecov](https://codecov.io/gh/VitalyOstanin/youtrack-mcp) ](https://www.npmjs.com/package/@vitalyostanin/youtrack-mcp)

MCP服务器，用于全面集成YouTrack，具有以下功能：

问题管理 -创建、更新、注释、分配、更改状态、批处理操作
问题主演 -用星号标记重要问题，批量主演（最多50个），列出主演问题
附件管理 -上传文件（最多10个），使用签名的网址下载，删除
工作项跟踪 -使用幂等操作创建条目，批量创建周期
详细的时间报告 -摘要报告、偏差分析、多用户统计
高级搜索 -通过快速/精确的过滤模式按用户活动查找问题
变更历史 -完整的问题活动日志，包括过滤和分页
知识库 -创建、更新、搜索具有层次结构的文章
用户和项目访问 -检索有关用户和项目的信息
批量操作 -同时高效处理多达50个问题
文件存储 -将大型工具结果保存为JSON文件，而不是直接返回
附加功能 -Markdown支持、折叠部分、假日配置、用户别名

- 目录 - 需求 - 安装 - 使用npx（推荐） - 使用Claude MCP命令行界面 - 手动安装（开发） - 开发与发布 - - - - - 发布过程 - 手动构建和测试 - 项目结构 - 运行服务器（stdio） - 代码配置（推荐） - Claude Code CLI的配置 - VS代码库配置 - MCP工具 - 文件存储参数 - 分页 - 破坏性操作确认 - 服务 - 问题 - 问题链接 - 问题状态 - 问题之星 - 附件 - 工作项 - 用户和项目 - 条款 - 搜索 - 活动提要 - 重要说明 - 破坏性行动

需求

Node.js≥22
环境变量：

- YOUTRACK_URL --YouTrack实例的基本URL - YOUTRACK_TOKEN --具有问题和工作项读取权限的永久令牌 - YOUTRACK_TIMEZONE --日期操作的可选时区（默认： Europe/Moscow)，必须是有效的IANA时区标识符（例如。， Europe/London, America/New_York, Asia/Tokyo) - YOUTRACK_HOLIDAYS --可选的逗号分隔的假期日期列表（格式 YYYY-MM-DD)，不包括在报告和批处理操作中

YOUTRACK_PRE_HOLIDAYS --可选的逗号分隔的假期前日期列表，工作时间缩短
YOUTRACK_USER_ALIASES --可选逗号分隔列表 alias:login 映射（例如。， me:vyt,petya:p.petrov)，用于自动选择受让人
YOUTRACK_DEFAULT_PROJECT --用于手动验证任务和文档/示例中默认父问题的可选项目代码（使用 PROJ 在文档示例中）
YOUTRACK_OUTPUT_DIR --由生成的文件的可选根目录 saveToFile 和 downloadToFile。默认为当前工作目录。绝对路径和父遍历段(..)因安全原因被拒绝
YOUTRACK_UPLOAD_DIR --用于源文件的可选白名单根目录 issue_attachment_upload.默认为 YOUTRACK_OUTPUT_DIR。为了防止读取任意文件，将拒绝实路径转义此目录（包括通过符号链接）的路径(/etc/passwd, ~/.ssh/id_rsa等等）

安装

使用npx（推荐）

您可以直接使用npx运行服务器，而无需安装：

YOUTRACK_URL="https://youtrack.example.com" \
YOUTRACK_TOKEN="perm:your-token-here" \
YOUTRACK_DEFAULT_PROJECT="PROJ" \
npx -y @vitalyostanin/youtrack-mcp@latest

使用Claude MCP命令行界面

使用Claude MCP CLI进行安装：

claude mcp add --scope user \
--env YOUTRACK_URL='https://youtrack.example.com' \
--env YOUTRACK_TOKEN='perm:my-token' \
youtrack-mcp -- npx -y @vitalyostanin/youtrack-mcp@latest

范围选项：

--scope user：为当前用户安装（所有项目）
--scope project：仅为当前项目安装

移除：

claude mcp remove youtrack-mcp --scope user

手动安装（开发）

npm install
npm run build

开发与发布

GitHub操作工作流

该项目使用GitHub Actions进行持续集成和自动发布：

CI工作流(`.github/workflows/ci.yml`)

在每次推送和拉取请求时自动运行：

触发器：所有分支，所有拉取请求
Node.js版本：22.x，24.x（矩阵测试）
步骤:

1. 安装依赖项(npm ci) 1. 运行门楣(npm run lint) 1. 建设项目(npm run build) 1. 验证构建工件（可执行文件检查）

发布工作流(`.github/workflows/publish.yml`)

创建新版本标记时自动运行：

触发：Git标签匹配 v* 模式（例如。， v0.1.0, v1.2.3)
Node.js版本：24.x
步骤:

1. 安装依赖项 1. 建设项目 1. 发布到npm注册表 1. 创建GitHub版本

设置NPM_TOKEN

要启用自动发布到npm，您需要配置 NPM_TOKEN 秘密：

生成npm访问令牌:

- 首选并登录 - 导航至 访问令牌 在您的帐户设置中 - 点击 生成新令牌 → 经典代币 - 选择 自动化 类型（用于CI/CD） - 复制生成的令牌

将Secret添加到GitHub:

- 转到您的GitHub存储库 - 导航至设置 → 秘密与变量 → 行动 - 点击 新存储库机密 - 姓名： NPM_TOKEN - 值：粘贴你的npm令牌 - 点击 添加机密

发布过程

要创建新版本，请执行以下操作：

# 1. Update version in package.json and create git tag
npm version patch   # for 0.1.0 → 0.1.1
# or
npm version minor   # for 0.1.0 → 0.2.0
# or
npm version major   # for 0.1.0 → 1.0.0

# 2. Push the tag to GitHub
git push --follow-tags

# 3. GitHub Actions will automatically:
#    - Run tests and build
#    - Publish to npm
#    - Create GitHub Release

备注：The npm version 命令自动执行：

更新 package.json 和 package-lock.json
创建一个git commit，并显示类似“0.1.1”的消息
创建类似“v0.1.1”的git标签

手动构建和测试

# Install dependencies
npm install

# Build the project
npm run build

# Run linter
npm run lint

# Watch mode for development
npm run dev:watch

项目结构

src/
  index.ts                MCP server entry point (stdio transport)
  server.ts               MCP server bootstrap, tool registration
  config.ts               YOUTRACK_* environment variable parsing
  constants.ts            HTTP timeouts, body limits, PRE_HOLIDAY_RATIO
  types.ts                Shared TypeScript interfaces and YouTrack entity discriminators
  youtrack-client.ts      YouTrack REST client with caching and pagination helpers
  tools/                  MCP tool registrations (one file per domain: issues, articles, ...)
  utils/                  Reusable helpers (date, file-storage, mappers, validators, tool-args, ...)
  __tests__/              Vitest tests against a nock-mocked HTTP layer
docs/
  reviews/                Project-check review reports
.github/
  workflows/              CI and publish workflows
  dependabot.yml          Weekly npm + github-actions update PRs
dist/                     Build output (generated by `npm run build`, gitignored)

权威代理导向的项目布局代理商.md.

运行服务器（stdio）

YOUTRACK_URL="https://youtrack.example.com" \
YOUTRACK_TOKEN="perm:example-token" \
node dist/index.js

代码配置（推荐）

增添 ~/.code/config.toml:

[mcp_servers.youtrack-mcp]
command = "npx"
args = ["-y", "@vitalyostanin/youtrack-mcp@latest"]

[mcp_servers.youtrack-mcp.env]
YOUTRACK_URL = "https://youtrack.example.com"
YOUTRACK_TOKEN = "perm:your-token-here"

Claude Code CLI的配置

使用此MCP服务器 Claude 代码命令行工具，您可以：

使用Claude MCP命令行界面 -看安装以上章节
手动配置 -添加到您的 ~/.claude.json 文件：

{
  "mcpServers": {
    "youtrack-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
      "env": {
        "YOUTRACK_URL": "https://youtrack.example.com",
        "YOUTRACK_TOKEN": "perm:your-token-here"
      }
    }
  }
}

注：此配置使用npx运行已发布的包。对于当地发展，使用 "command": "node" 随着 "args": ["/absolute/path/to/youtrack-mcp/dist/index.js"]The YOUTRACK_TIMEZONE, YOUTRACK_HOLIDAYS, YOUTRACK_PRE_HOLIDAYS，以及 YOUTRACK_USER_ALIASES 环境变量是可选的。

VS代码库配置

使用此MCP服务器克莱恩 VS代码中的扩展名：

打开安装了Cline扩展的VS代码
单击Cline顶部导航中的MCP服务器图标
选择“配置”选项卡，然后单击“配置MCP服务器”
将以下配置添加到 cline_mcp_settings.json:

{
  "mcpServers": {
    "youtrack-mcp": {
      "command": "npx",
      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
      "env": {
        "YOUTRACK_URL": "https://youtrack.example.com",
        "YOUTRACK_TOKEN": "perm:your-token-here"
      }
    }
  }
}

MCP工具

文件存储参数

许多工具支持用于处理大型数据集的可选文件存储参数：

saveToFile --boolean，将结果保存到JSON文件中，而不是直接返回（适用于大型数据集）
filePath --字符串，相对于的自定义文件路径 YOUTRACK_OUTPUT_DIR （可选，如果没有提供，则自动生成，如果需要，则创建目录）
format --string，保存到文件时的输出格式： jsonl （JSON行）或 json （JSON数组格式）。默认值为 jsonl
overwrite --boolean，允许在使用显式filePath时覆盖现有文件。默认值为 false

当 saveToFile 是 true，工具返回有关已保存文件的元数据，而不是完整数据。所有路径均已解决 YOUTRACK_OUTPUT_DIR；绝对路径和 .. 遍历段被拒绝。

分页

大多数阅读工具都接受 limit （默认值为100，最大值为200）以及 skip （默认值0）；两者都以以下身份转发到YouTrack $top/$skip.返回汇总计数的工具使用 returned （当前页面中的项目计数）而不是 total.使用连续 skip 遍历大型结果集的值。

破坏性操作确认

删除数据的工具需要明确的 confirmation: true 输入中的文字：

issue_attachment_delete
issue_link_delete
workitem_delete

服务

工具	说明	主要参数
`service_info`	检查YouTrack的可用性和当前用户	--

问题

工具	说明	主要参数
`issue_lookup`	获取有关YouTrack问题的信息。注意：返回预定义的字段，包括时间戳（创建、更新）和基本信息-id、idReadable、摘要、描述、wikifiedDescription、usesMarkdown、创建、更新、项目（id、shortName、name）、父级（id、idReadble）、受让人（id、登录名、名称）、报告人。默认情况下，不包括自定义字段。使用briefOutput=false获取包括State在内的所有自定义字段。	`issueId` --发布代码（例如PROJ-123）； `briefOutput` --可选布尔值（默认值 `true`)
`issues_lookup`	获取有关多个YouTrack问题的信息（批处理模式，最多50个）。注意：返回预定义的字段，包括时间戳（创建、更新）和基本信息-id、idReadable、摘要、描述、wikifiedDescription、usesMarkdown、创建、更新、项目（id、shortName、name）、父级（id、idReadble）、受让人（id、登录名、名称）、报告人。默认情况下，不包括自定义字段。使用briefOutput=false获取包括State在内的所有自定义字段。	`issueIds[]` --问题代码数组（例如，\[‘PROJ-123’、‘PROJ-124’\]），最多50个； `briefOutput` --可选布尔值（默认值 `true`)
`issue_details`	以简短/完整模式发布详细信息	`issueId` --发行代码； `briefOutput` --可选布尔值（默认值 `true`).简介：仅限预定义字段。满(`false`)：添加 `customFields` 包括 `State`; `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`issues_details`	关于多个问题的详细信息（批处理模式，最多50个）。简短（默认）：仅预定义字段。满(`briefOutput=false`)：添加 `customFields` 对于每个问题	`issueIds[]` --发行代码数组，最多50个； `briefOutput` --可选布尔值（默认值 `true`); `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`issue_comments`	使用服务器端分页发布评论	`issueId` --发行代码； `limit` （默认100，最大200）， `skip` 用于分页； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`issues_comments`	多个问题的评论（批处理模式，最多50条）	`issueIds[]` --发行代码数组，最多50个； `briefOutput` --可选布尔值（默认值 `true`); `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`issue_create`	创建问题	`projectId`, `summary`，可选 `description`, `parentIssueId`, `assigneeLogin`, `stateName`, `usesMarkdown`, `links` （链接对象数组）
`issue_update`	更新现有问题	`issueId`，可选 `summary`, `description`, `parentIssueId` （空字符串清除父字符串）， `usesMarkdown`
`issue_assign`	将问题分配给用户	`issueId`, `assigneeLogin` （登录或 `me`)
`issue_comment_create`	向问题添加评论	`issueId`, `text` --评论文本，可选 `usesMarkdown`
`issue_comment_update`	更新现有评论	`issueId`, `commentId`，可选 `text`, `usesMarkdown`, `muteUpdateNotifications`
`issue_activities`	获取问题更改历史记录	`issueId` --问题代码，可选 `author` （登录）， `startDate` （YYYY-MM-DD、时间戳或日期）， `endDate`, `categories` （逗号分隔： `CustomFieldCategory` 对于字段更改， `CommentsCategory` 对于评论， `AttachmentsCategory` 对于附件， `LinksCategory` 对于链接， `VcsChangeActivityCategory` 对于VCS变化， `WorkItemsActivityCategory` 对于工作项）， `limit` （最大200）， `skip` 用于分页； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项。返回带有时间戳（ISO日期时间）、作者、类别和更改详细信息（添加/删除值）的活动项。可用于跟踪字段修改、查看评论历史记录和分析协作模式
`issue_change_state`	通过工作流转换更改问题状态/状态	`issueId` --发行代码， `stateName` --目标状态名称（例如，“进行中”、“打开”、“已修复”、“验证”）。不区分大小写自动发现可用的转换并验证请求的状态更改。返回有关以前状态、新状态和使用的转换的信息。用于在工作流状态中移动问题
`issue_attachments_list`	获取附件列表	`issueId` --发行代码； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`issue_attachment_get`	获取附件信息	`issueId`, `attachmentId`; `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`issue_attachment_download`	获取附件的下载URL或将文件直接下载到本地文件系统	`issueId`, `attachmentId` --当downloadToFile=false时，返回签名的下载URL； `downloadToFile` --boolean，直接将文件下载到本地系统（默认值：false）； `downloadPath` --保存文件的自定义路径（如果未提供，则自动生成）； `overwrite` --允许覆盖现有文件（默认值：false，如果文件存在则抛出错误）； `saveToFile`, `filePath`, `format`, `overwrite` --元数据的文件存储选项
`issue_attachment_upload`	上传文件以发布	`issueId`, `filePaths[]` --文件路径数组（最多10个），可选 `muteUpdateNotifications`
`issue_attachment_delete`	删除附件（需要 `confirmation: true`)	`issueId`, `attachmentId`, `confirmation` （必须是布尔值文字 `true`)

问题链接

工具	说明	主要参数
`issue_links`	列出服务器端分页问题的链接。返回链接id、方向、linkType和对应问题摘要	`issueId` --发行代码； `limit` （默认100，最大200）， `skip` 用于分页
`issue_link_types`	列出可用的链接类型（缓存的单航班）	--
`issue_link_add`	在两个问题之间建立联系	`sourceId`, `targetId`, `linkType` （姓名或id），可选 `direction` (`outbound` 或 `inbound`)
`issue_link_delete`	按id删除特定问题的链接（需要 `confirmation: true`)	`issueId`, `linkId`，可选 `targetId`, `confirmation` （必须是布尔值文字 `true`)

问题状态

工具	说明	主要参数
`issue_status`	获取YouTrack问题的状态。返回问题的状态。	`issueId` --发布代码（例如PROJ-123）
`issues_status`	获取多个YouTrack问题的状态（批处理模式，最多50个）。返回每个问题的状态。	`issueIds[]` --问题代码数组（例如，\[‘PROJ-123’、‘PROJ-124’\]），最多50个

问题之星

工具	说明	主要参数
`issue_star`	为当前用户的问题添加星号	`issueId` --问题代码（例如PROJ-123）。Idempotent操作-即使已经星级，也会返回成功
`issue_unstar`	从当前用户的问题中删除星号	`issueId` --问题代码。Idempotent操作-即使当前没有星级，也会返回成功
`issues_star_batch`	为多个问题添加星号（批处理模式，最多50个）	`issueIds[]` --问题代码数组（最多50个）。返回对象 `successful` 和 `failed` 阵列。具有并发限制的进程（10个并发请求）
`issues_unstar_batch`	从多个问题中删除星号（批处理模式，最多50个）	`issueIds[]` --问题代码数组（最多50个）。返回对象 `successful` 和 `failed` 阵列。具有并发限制的进程（10个并发请求）
`issues_starred_list`	获取当前用户的所有星号问题	可选 `limit` （默认50，最大200）， `skip` 用于分页。返回带基本信息（id、idReadable、摘要、项目、父级、受让人）的星号问题数组，不带描述字段

工作项

工具	说明	主要参数
`workitems_list`	使用服务器端分页为当前或指定用户获取工作项	可选 `issueId`, `author`, `startDate`, `endDate`, `allUsers`; `limit` （默认100，最大200）， `skip` 用于分页； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`workitems_all_users`	使用服务器端分页为所有用户获取工作项	可选 `issueId`, `startDate`, `endDate`; `limit` （默认100，最大200）， `skip` 用于分页； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`workitems_for_users`	通过按用户分页为所选用户获取工作项	`users[]`，可选 `issueId`, `startDate`, `endDate`; `limit` （默认100，最大200）， `skip` 按用户应用； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`workitems_recent`	获取按更新时间排序的最近工作项（最新的优先）	可选 `users[]` （默认为当前用户）， `limit` （默认值50，最大值200）； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`workitem_create`	创建工作项条目	`issueId`, `date`, `minutes`，可选 `summary`, `description`, `usesMarkdown`
`workitem_create_idempotent`	创建不重复的工作项（按描述和日期）	`issueId`, `date`, `minutes`, `description`，可选 `usesMarkdown`
`workitem_update`	更新工作项（重新创建）	`issueId`, `workItemId`，可选 `date`, `minutes`, `summary`, `description`, `usesMarkdown`
`workitem_delete`	删除工作项（需要 `confirmation: true`)	`issueId`, `workItemId`, `confirmation` （必须是布尔值文字 `true`)
`workitems_create_period`	批量创建日期范围	`issueId`, `startDate`, `endDate`, `minutes`，可选 `summary`, `description`, `usesMarkdown`, `excludeWeekends`, `excludeHolidays`, `holidays[]`, `preHolidays[]`
`workitems_report_summary`	工作项摘要报告	常用参数： `author`, `issueId`, `startDate`, `endDate`, `expectedDailyMinutes`, `excludeWeekends`, `excludeHolidays`, `holidays[]`, `preHolidays[]`, `allUsers`; `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`workitems_report_invalid`	偏离预期小时数的天数	与摘要参数相同； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`workitems_report_users`	用户列表的工作项报告	`users[]` +常用报表参数； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`workitems_report`	报告结构（与旧客户端兼容）	可选 `author`, `issueId`, `startDate`, `endDate`, `expectedDailyMinutes`, `excludeWeekends`, `excludeHolidays`, `holidays[]`, `preHolidays[]`, `allUsers`; `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项

用户和项目

工具	说明	主要参数
`users_list`	列出所有服务器端分页的YouTrack用户	`limit` （默认100，最大200）， `skip` 用于分页； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`user_get`	通过登录获取用户	`login` --用户登录
`user_current`	获取当前已通过身份验证的用户	--
`projects_list`	列出所有YouTrack项目（默认情况下自动分页；通过 `limit`/`skip` 用于显式分页）	可选 `limit` （最大200）， `skip`
`project_get`	通过短名称获取项目	`shortName` --项目简称

条款

工具	说明	主要参数
`article_get`	按ID获取文章	`articleId`
`article_list`	列出带有过滤器和服务器端分页的文章	可选 `parentArticleId`, `projectId`; `limit` （默认100，最大200）， `skip` 用于分页
`article_create`	在知识库中创建文章	`summary`，可选 `content`, `parentArticleId`, `projectId`, `usesMarkdown`, `returnRendered`
`article_update`	更新文章	`articleId`，可选 `summary`, `content`, `usesMarkdown`, `returnRendered`
`article_search`	在知识库中搜索文章	`query`，可选 `projectId`, `parentArticleId`, `limit`, `returnRendered`; `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`articles_search`	按标题和内容在YouTrack知识库文章中进行全文搜索。退货 `webUrl` 用于直接访问。	`query`, `limit`, `skip`，可选 `projectId`, `parentArticleId`; `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`issues_search`	按摘要、描述和评论对YouTrack问题进行全文搜索。如果 `query` 未提供或为空，所有问题都将被退回。支持按项目、受让人、报告人、州和类型进行筛选。	`query` （可选）， `limit`, `skip`, `countOnly` （可选）， `projects` （可选）， `assignee` （可选）， `reporter` （可选）， `state` （可选）， `type` （可选）； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项

搜索

工具	说明	主要参数
`articles_search`	按标题和内容在YouTrack知识库文章中进行全文搜索。退货 `webUrl` 用于直接访问	`query` （最少2个字符）， `limit` （默认50，最大200）， `skip`，可选 `projectId`, `parentArticleId`
`issues_search`	按摘要、描述和评论对YouTrack问题进行全文搜索。如果 `query` 未提供或为空，所有问题都将被退回。支持按项目、受让人、报告人、州和类型进行筛选	`query` （可选）， `limit` （默认50，最大200）， `skip`, `countOnly` （可选）， `projects` （可选）， `assignee` （可选）， `reporter` （可选）， `state` （可选）， `type` （可选）

活动提要

工具	说明	主要参数
`users_activity`	以作者为中心的活动提要，由 `/api/activities`. 用途：审核队友的更新，收集许多问题的评论/状态变化，并审查部署时间表。返回具有ISO时间戳、可选问题引用和 `added`/`removed` 有效载荷。始终通过重新获取受影响的问题或工作项来确认最新状态。支持的类别： `CustomFieldCategory` （字段更改）， `CommentsCategory` （评论）， `AttachmentsCategory` （文件事件）， `LinksCategory` （问题链接）， `VcsChangeActivityCategory` （VCS变化）， `WorkItemsActivityCategory` （工作项目）。	`author` （必填） --登录，例如 `vyt`; `categories` （必填） --由上述支持的类别构建的逗号分隔列表；可选的 `start` / `end` （ISO字符串、时间戳（毫秒），或 `Date`)为了限制该范围， `reverse` （布尔值）切换到时间顺序， `limit` （默认100，最大200）， `skip` （分页偏移）， `fields` （高级覆盖响应字段）； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项。
`issues_list`	使用筛选和排序列出跨项目的问题	筛选器： `projectIds`, `createdAfter/Before`, `updatedAfter/Before`, `statuses`, `assigneeLogin`, `types`；排序： `sortField`, `sortDirection`；分页： `limit`, `skip`；输出模式： `briefOutput`; `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项
`issues_count`	使用与相同的筛选器统计问题 `issues_list`，按项目细分返回	与上述过滤器相同，可选 `top` 当涉及许多项目时，限制手动聚合； `saveToFile`, `filePath`, `format`, `overwrite` --文件存储选项

重要说明

破坏性行动

某些操作无法撤消，需要显式 confirmation: true 输入中的文字：

issue_attachment_delete --已删除的附件无法恢复。

issue_link_delete --重新取回 issue_links 之后，为了验证关系是否被删除。

workitem_delete --工作项条目永久丢失；重新取回 workitems_list 以确认。

issue_create参数：

parentIssueId --坚决反对 YOUTRACK_DEFAULT_PROJECT 当没有提供项目前缀时（例如。， 123 → BC-123 如果默认项目为 BC).

links[] --描述保存问题后要创建的其他链接的可选数组。每个项目支持：

- linkType --链接类型的名称或id（例如。， Subtask, Relates). - targetId --问题id或可读id。普通数字使用默认项目解决，匹配 resolveIssueId 行为。 - direction --可选("outbound" 默认情况下）。使用 "inbound" 翻转非对称链接类型的方向。 - sourceId --可选。如果省略，新问题将被视为源。指定以创建从现有问题到新问题的链接（对复杂链很有用）。

创建后，该工具会自动刷新问题并尝试重新打开链接缓存；始终重新获取链接 issue_links 以确认最终状态。

Youtrack MCP

快速接入

详细介绍