Youtrack MCP

MCP办公协作

提供方 VitalyOstanin · 包名 @vitalyostanin/youtrack-mcp@latest

办公协作 stdio · 本地进程 Token 社区 / 第三方 ClaudeCline
查看接入方式

YouTrack MCP服务器提供全面的问题管理、附件管理、工作项跟踪和时间报告等功能,适用于团队协作和项目管理场景。

一句话选型结论

按资料字段整理

Youtrack MCP 属于办公协作类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude、Cline,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 58 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量58暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

问题管理TypeScript本地部署团队协作项目管理时间跟踪知识库

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
npx -y @vitalyostanin/youtrack-mcp@latest

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 58 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 58 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cline,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cline 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Youtrack MCP当前 58 stdio · 本地进程 本地部署 有 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方VitalyOstanin上游标注的维护方 VitalyOstanin
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@vitalyostanin/youtrack-mcp@latest · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

26.3 KB
来自项目仓库与上游目录的原文,未做删改

YouTrack MCP服务器

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

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

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

目录

  • YouTrack MCP服务器
  • 目录
  • 需求
  • 安装
  • 使用npx(推荐)
  • 使用Claude MCP命令行界面
  • 手动安装(开发)
  • 开发与发布
  • GitHub操作工作流
  • CI工作流(.github/workflows/ci.yml)
  • 发布工作流(.github/workflows/publish.yml)
  • 设置NPM_TOKEN
  • 发布过程
  • 手动构建和测试
  • 项目结构
  • 运行服务器(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运行服务器,而无需安装:```bash
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进行安装:```bash
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:仅为当前项目安装

移除:```bash
claude mcp remove youtrack-mcp --scope user


### 手动安装(开发)```bash
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 秘密:

  1. 生成npm访问令牌:
  • 首选 npmjs.com 并登录
  • 导航至 访问令牌 在您的帐户设置中
  • 点击 生成新令牌 → 经典代币
  • 选择 自动化 类型(用于CI/CD)
  • 复制生成的令牌
  1. 将Secret添加到GitHub:
  • 转到您的GitHub存储库
  • 导航至 设置 → 秘密与变量 → 行动
  • 点击 新存储库机密
  • 姓名: NPM_TOKEN
  • 值:粘贴你的npm令牌
  • 点击 添加机密

发布过程

要创建新版本,请执行以下操作:```bash

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标签

### 手动构建和测试```bash
# 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)```bash
YOUTRACK_URL="https://youtrack.example.com" \
YOUTRACK_TOKEN="perm:example-token" \
node dist/index.js

代码配置(推荐)

增添 ~/.code/config.toml:```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 代码命令行工具,您可以:

1. **使用Claude MCP命令行界面** -看 安装 以上章节
1. **手动配置** -添加到您的 `~/.claude.json` 文件:```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代码中的扩展名:

  1. 打开安装了Cline扩展的VS代码
  2. 单击Cline顶部导航中的MCP服务器图标
  3. 选择“配置”选项卡,然后单击“配置MCP服务器”
  4. 将以下配置添加到 cline_mcp_settings.json: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" } } } }

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

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 以确认最终状态。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Youtrack MCP 怎么安装?

在客户端按下面的安装命令接入:npx -y @vitalyostanin/youtrack-mcp@latest。对应的包名是 @vitalyostanin/youtrack-mcp@latest。装完在客户端配置里引用同一个包或端点。

Youtrack MCP 怎么在 Claude、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Youtrack MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Youtrack MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Youtrack MCP 支持哪些客户端?

资料标注支持 Claude、Cline;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Youtrack MCP 能提供哪些能力?

资料显示约 58 个工具;能力标签包括 问题管理、时间跟踪、TypeScript、Claude、团队协作。具体工具清单以官方文档为准。

Youtrack MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Youtrack MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。