SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台yandex-tracker-mcp

yandex-tracker-mcp

yandex-tracker-mcp 是一个 Model Context Protocol (MCP) 服务器，让 AI 助手能够通过安全的认证接口访问 Yandex Tracker 的 API。它提供对 Yandex Tracker 问题（issues）、队列（queues）、评论、工作日志以及搜索功能的访问，并可选使用 Redis 缓存来提升性能。该服务器支持 OAuth 2.0 动态令牌认证与自动刷新，也支持静态 API 令牌、IAM 令牌和服务账号凭据；支持 stdio、SSE（已弃用）和 HTTP 等多种传输方式，可用于 Claude Desktop、Cursor、Windsurf、Zed 和 VS Code 等兼容 MCP 的客户端。主要工具覆盖队列管理、用户管理、问题全生命周期、状态流转、字段管理、敏捷看板与冲刺、以及 Tracker 查询语言（含复杂过滤、排序和日期函数）。可以配置队列访问限制和只读模式等安全控制。

访问官网

工具介绍

yandex-tracker-mcp 是一个全面的 Model Context Protocol（MCP）服务器，旨在让 AI 助手与 Yandex Tracker API 进行交互。它通过认证保护，提供对 Yandex Tracker 的问题、队列、评论、工作日志和搜索功能的访问，并可选用 Redis 缓存来改善响应速度。

主要能力

  • 队列管理：列出并访问所有可用的 Yandex Tracker 队列，支持分页、标签获取和详细元数据。
  • 项目、组合与目标：针对 Tracker “entities” API 中各实体类型的独立读写工具，通过 TRACKER_ENTITIES_ENABLED 选择性启用。
  • 用户管理：获取用户账户信息，包括登录详情、电子邮件地址、许可证状态和组织数据。
  • 问题全生命周期：创建、读取、更新和管理问题，支持自定义字段、附件和工作流转换。
  • 状态工作流管理：执行状态转换、以解决方案关闭问题，并导航复杂的工作流。
  • 字段管理：访问全局字段、队列本地字段、状态、问题类型、优先级和解决方案。
  • 看板与冲刺：列出敏捷看板及其冲刺，以查找用于问题规划的冲刺 ID。
  • 高级查询语言：完整支持 Yandex Tracker 查询语言，包括复杂过滤、排序和日期函数。
  • 性能缓存：可选的 Redis 缓存层，用于改善响应时间。
  • 安全控制：可配置的队列访问限制和安全令牌处理。
  • 多种传输方式：支持 stdio、SSE（已弃用）和 HTTP 传输，便于灵活集成。
  • OAuth 2.0 认证：动态基于令牌的认证，支持自动刷新，作为静态 API 令牌的替代方案。
  • 组织支持：兼容标准组织和云组织 ID。

使用方式

组织 ID 配置

根据 Yandex 组织类型选择其一：

  • Yandex Cloud 组织：使用 TRACKER_CLOUD_ORG_ID 环境变量
  • Yandex 360 组织：使用 TRACKER_ORG_ID 环境变量 组织 ID 可在 Yandex Tracker URL 或组织设置中找到。设置其中一个即可，同时设置两者会导致所有 Tracker 调用失败。

在 Claude Desktop 中安装扩展

该服务器可作为扩展一键安装到 Claude Desktop：

  1. 从 GitHub Releases 下载 *.mcpb 文件。
  2. 双击下载的文件安装到 Claude Desktop。
  3. 按提示提供 Yandex Tracker OAuth 令牌。
  4. 确保扩展已启用。

手动安装

需要全局安装 uv，并持有具有适当权限的有效 Yandex Tracker API 令牌。可以使用 uvx yandex-tracker-mcp@latest 或 Docker 镜像 ghcr.io/aikts/yandex-tracker-mcp:latest。两者都需要环境变量：

  • 认证（任选其一）：TRACKER_TOKEN、TRACKER_IAM_TOKEN，或 TRACKER_SA_KEY_ID、TRACKER_SA_SERVICE_ACCOUNT_ID、TRACKER_SA_PRIVATE_KEY（服务账号凭据）。
  • 组织（任选其一）：TRACKER_CLOUD_ORG_ID 或 TRACKER_ORG_ID。

各客户端配置路径

  • Claude Desktop：macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 为 %APPDATA%\Claude\claude_desktop_config.json。
  • Cursor：项目级为 .cursor/mcp.json，全局为 ~/.cursor/mcp.json。
  • Windsurf：~/.codeium/windsurf/mcp_config.json，也可通过 Windsurf Settings → Cascade 标签 → Model Context Protocol (MCP) Servers → “View raw config” 访问。
  • Zed：~/.config/zed/settings.json，通过 Cmd+,（macOS）或 Ctrl+,（Linux/Windows）或命令面板 “zed: open settings” 访问；需要 Zed 预览版才支持 MCP。
  • VS Code：工作区为 .vscode/mcp.json，全局为 VS Code settings.json。

配置更改后需重启 AI 客户端；确保 uvx 已安装并在系统 PATH 中可用；生产环境建议使用环境变量而非硬编码令牌。

可用 MCP 工具要点

服务器通过 MCP 协议暴露多种工具，涉及以下使用细节：

  • 在 issue_create 之前先读取 queue_get_fields，但系统字段（如 parent、estimation）无需出现其中也可设置；get_global_fields 列出组织拥有的全部字段。
  • issue_close 所需的解决方案来自 queue_get_metadata 的 expand: ["issueTypesConfig"]，每个问题类型有各自的解决方案集合。
  • queues_get_all 的 hits/pages 仅在无允许列表的服务器上用于显式单页请求时报告。
  • 组件（component）是按产品、流程或负责人对队列问题分组的一种标签，其数字 id 用于 issue_create/issue_update 的 components 参数。
  • TRACKER_LIMIT_QUEUES 和 TRACKER_READ_ONLY_QUEUES 通过组件所属队列生效：component_update 和 component_delete 会先读取组件以了解其队列，属于受限队列的组件会被报告为未找到。
  • 项目、组合和目标是通过 Tracker “entities” API 暴露的独立实体，与队列不同；组织自定义属性不被建模，也不返回。这些工具通过 TRACKER_ENTITIES_ENABLED=true 选择性启用（默认 false），且不受队列限制覆盖。
  • links 只会被添加，从不替换，且 API 不会返回它们；现有链接无法通过此服务器读回或删除，仅更新 links 会被拒绝。
  • users_search 先精确匹配登录名和电子邮件，再回退到模糊名称匹配（80% 相似度，最多三个最佳匹配）。
  • 队列本地字段不单独列出，queue_get_fields 会连同全局字段一起返回。
  • 模板为只读辅助：API 无法从模板创建问题或评论，需读取模板并将其值作为写入工具的参数传入；像 {{today}} 这类宏会按字面返回。
  • 看板属于组织而非队列，TRACKER_LIMIT_QUEUES 不会过滤它们；非 scrum 看板没有冲刺，board_get_sprints 会被拒绝。
  • version 会自行过期，队列触发器和自动化在 issue_create 后立即运行并使其更新，因此应在 issue_update 前用 issue_get 立即重新读取，或省略以无条件更新最新版本。
  • 转换不应猜测，issue_execute_transition 只接受 issue_get_transitions 返回的 id。

streamable-http 与 OAuth 2.0

服务器可运行在 streamable-http 模式，用于基于 Web 的集成或 stdio 传输不合适时。OAuth 2.0 认证作为静态 API 令牌的安全替代方案：服务器充当 OAuth 提供者，促进 MCP 客户端与 Yandex OAuth 服务之间的认证。流程包括客户端注册、授权重定向到 Yandex OAuth、令牌交换、API 访问和令牌刷新。启用 OAuth 需设置相应环境变量；OAUTH_USE_SCOPES=true（默认）时请求并强制 tracker:read 和 tracker:write 作用域，TRACKER_READ_ONLY=true 时仅请求 tracker:read。需在 Yandex OAuth 创建应用，回调 URL 设为 {MCP_SERVER_PUBLIC_URL}/oauth/yandex/callback，并申请 tracker:read 和 tracker:write 权限，保存 Client ID 和 Client Secret。OAuth 模式要求 MCP 服务器可公开访问以处理回调，最适合支持基于 Web 认证流程的交互式客户端。

同类工具

查看分类