Ya Tracker MCP

ya追踪器mcp

MCP服务器 Yandex跟踪器 API提供146个工具，用于通过 模型上下文协议.

建于 FastMCP 和 YaTrackerApi.

快速开始

克劳德代码

claude mcp add ya-tracker \
  -e YA_TRACKER_TOKEN=your-oauth-token \
  -e YA_TRACKER_ORG_ID=your-org-id \
  -- uvx ya-tracker-mcp

克劳德桌面版

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "ya-tracker": {
      "command": "uvx",
      "args": ["ya-tracker-mcp"],
      "env": {
        "YA_TRACKER_TOKEN": "your-oauth-token",
        "YA_TRACKER_ORG_ID": "your-org-id"
      }
    }
  }
}

光标/风帆

添加到MCP设置：

{
  "ya-tracker": {
    "command": "uvx",
    "args": ["ya-tracker-mcp"],
    "env": {
      "YA_TRACKER_TOKEN": "your-oauth-token",
      "YA_TRACKER_ORG_ID": "your-org-id"
    }
  }
}

认证

您需要OAuth令牌和组织ID：

1. OAuth令牌 -得到在 oauth.yandex.ru 具有跟踪器访问权限
2. 组织ID -在Tracker管理设置中或通过API找到 GET /v3/myself

工具（146）

问题（7）

评论（4）

状态转换（2）

链接（3）

实体-项目/投资组合/目标（23）

滑板与短跑（12）

工作日志（5）

检查表（5）

附件（2）

排队（10）

用户（3）

缓存管理（4）

通用参数： 大多数 list_*, get_* 和 search_* 工具（问题、实体、队列、组件、电路板、精灵、用户、字段）现在支持： - fields: list[str] --要显示的其他字段。使用 ["all"] 查看API中可用的每个字段。 - output_format: str --响应格式： "text" （默认，降价）或 "json" （用于编程的结构化数据）。 - full_description: bool --设置为 true 返回完整描述而不截断（默认值： false，截断为1000个字符）。 - use_cache: bool --（对于缓存的工具）设置为 False 绕过本地缓存并从Yandex Tracker获取新数据。

目录——参考数据（27）

自动化（15）

批量操作（5）

批量阅读（1）

并行扇出用于读取操作——一个工具调用而不是N，默认情况下输出紧凑。

进口（4）

过滤器（3）

仪表板（2）

外部链接（4）

概览（2）

预设（5）

团队目录（3）

资源（7）

提示（4）

配置

任务预设

在中定义预设 ~/.cache/ya-tracker-mcp/presets.yaml 或在运行时使用 add_preset / remove_preset. params 部分支持以下所有字段 create_issue （类型、优先级、受让人、标签、组件、冲刺、父级、项目、追随者、截止日期、故事点、原始估计、额外字段）：

presets:
  bug_report:
    name: "Bug report"
    description: "Bug with reproduction steps"
    params:
      type: "bug"
      priority: "critical"
      tags: ["bug", "regression"]
      components: ["API"]
    description_template: |
      ## Steps to reproduce
      {input.steps}
      ## Expected
      {input.expected}
      ## Actual
      {input.actual}
    rules:
      - "Always include reproduction steps"

团队目录

编辑 ~/.cache/ya-tracker-mcp/team.yaml 启用智能受让人建议：

team:
  - login: "user3370"
    name: "Ivan Ivanov"
    role: "Backend developer"
    areas: ["API", "auth", "databases"]
    queues: ["DEV"]
    notes: "Tech lead"

查询语言示例

# My open tasks
Assignee: me() Resolution: empty()

# Critical bugs
Type: bug Priority: Critical, Blocker Resolution: empty()

# Overdue tasks
Deadline: today()-1w Queue: DEV

# Tasks in sprint
Sprint: "Sprint 24" Resolution: empty()

发展

git clone https://github.com/keemor/ya-tracker-mcp.git
cd ya-tracker-mcp
uv sync

# Run locally
YA_TRACKER_TOKEN=... YA_TRACKER_ORG_ID=... uv run ya-tracker-mcp

许可证

麻省理工学院