Skip to main content
Glama

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Yandex Tracker API, enabling AI assistants to search, read, create, and edit issues, as well as manage comments, attachments, and links in Yandex Tracker.
      46 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for interacting with YouTrack, enabling issue management, project operations, and search via natural language.
      308 npm
      100
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server for YouTrack integration, providing a standardized interface for LLMs to interact with YouTrack's issue tracking, agile management, and knowledge base features.
      12
      MIT