youtrack-mcp
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 --watchTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for generating rough-draft project plans from natural-language prompts.
A MCP server built for developers enabling Git based project management with project and personal…
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP 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 npm1MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for interacting with YouTrack, enabling issue management, project operations, and search via natural language.308 npm100MIT
- AlicenseBqualityDmaintenanceA 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.12MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for comprehensive YouTrack integration, enabling issue management, work tracking, search, and knowledge base operations.319 npm6MIT