youtrack-mcp

一个用于 YouTrack 的 MCP 服务器，使用 TypeScript 和 Bun 构建。它适用于任何 YouTrack 实例（Cloud 或自托管）——你只需提供基础 URL 和 API 令牌，无需硬编码任何内容。

设置

你需要一个 YouTrack 永久令牌：在 YouTrack 中，前往你的个人资料 → 账户安全 → 新建令牌...。

设置两个环境变量：

• YOUTRACK_BASE_URL — 你的实例的 REST API 基础 URL，例如 https://mycompany.youtrack.cloud/api，或自托管安装的 https://youtrack.mycompany.com/api。

• YOUTRACK_TOKEN — 永久令牌。

使用 Bun 安装依赖：

bun install

直接运行

YOUTRACK_BASE_URL=https://mycompany.youtrack.cloud/api YOUTRACK_TOKEN=perm:xxxx bun run src/index.ts

在 MCP 客户端中配置

例如，在 Claude Code / Claude Desktop 的 mcp.json 中：

{
  "mcpServers": {
    "youtrack": {
      "command": "bun",
      "args": ["run", "/path/to/youtrack-mcp/src/index.ts"],
      "env": {
        "YOUTRACK_BASE_URL": "https://mycompany.youtrack.cloud/api",
        "YOUTRACK_TOKEN": "perm:xxxx"
      }
    }
  }
}

Related MCP server: YouTrack MCP

工具

工具按资源分组，并共享一个 fields 参数（YouTrack 的部分响应语法），带有合理的默认值，因此你只需在需要更多或更少数据时指定它。

• 问题 — list_issues（搜索）、get_issue、create_issue、update_issue、delete_issue、execute_command（通过其自然查询语法应用任何 YouTrack 命令——状态、经办人、优先级、链接、标签、冲刺等，例如 "State Fixed assignee John.Doe"）

• 评论 — list_issue_comments、add_issue_comment、update_issue_comment、delete_issue_comment

• 链接 — list_issue_links、list_issue_link_types

• 标签 — list_tags、create_tag、list_issue_tags、add_issue_tag、remove_issue_tag

• 时间跟踪 — list_issue_work_items、add_issue_work_item、update_issue_work_item、delete_issue_work_item、list_work_items

• 项目 — list_projects、get_project、create_project、update_project、list_project_custom_fields

• 用户与组 — get_current_user、list_users、get_user、list_groups

• 知识库 — list_articles、get_article、create_article、update_article、delete_article

• 敏捷看板 — list_agile_boards、get_agile_board、list_sprints、get_sprint

• 已保存的搜索 — list_saved_queries

• 逃生舱 — youtrack_raw_request 直接调用 YouTrack REST API 的任何端点（方法、路径、查询、请求体），用于处理专用工具未涵盖的长尾管理/设置端点。

设计

• src/youtrack/client.ts — 唯一直接与 HTTP 通信的地方：认证头、URL/查询构建、JSON 与错误处理。所有工具都通过它。

• src/youtrack/fields.ts — 每个实体的默认 fields 预设，取自 YouTrack 自己的 OpenAPI 默认值。

• src/youtrack/params.ts — 共享的 Zod 模式片段（fields、分页、ID），在多个工具间复用。

• src/tool.ts — defineTool + registerTools，因此每个工具文件只需声明名称/描述/模式/处理器，MCP 响应/错误包装在一个地方完成。

• src/youtrack/tools/*.ts — 每个资源一个文件，每个工具只有几行，基于上述共享组件构建。

开发

bun run typecheck   # tsc --noEmit
bun run dev         # run with --watch