Skip to main content
Glama
YaTracker Connector

YaTracker Connector

YaTracker 连接器

用于操作 Yandex Tracker API 的 Python 库和 MCP 服务器。

🚀 快速开始

选项 1:Docker(推荐)

使用 MCP 服务器的最简单方法:

# 1. Создайте .env файл
cp config/sample.env .env
# Отредактируйте .env и добавьте свои credentials

# 2. Запустите
docker-compose up -d

# Готово! MCP сервер работает на порту 8080

Docker 的优势:

  • ✅ 无需绝对路径

  • ✅ 在任何地方运行效果一致

  • ✅ 易于与同事共享

  • ✅ 不会与其他项目冲突

📖 详情请见:DOCKER.md

选项 2:本地安装

# 1. Установите зависимости
pip install -r requirements.txt

# 2. Создайте .env
cp config/sample.env .env
# Добавьте YATRACKER_TOKEN и YATRACKER_ORG_ID

# 3. Используйте CLI
PYTHONPATH=src python3.11 -m scripts.cli issues list --queue CRM

📖 详情请见:QUICKSTART.md

Related MCP server: Yandex Tracker MCP

📚 文档

🔧 功能

CLI (命令行界面)

# Список задач
PYTHONPATH=src python3.11 -m scripts.cli issues list --queue CRM --limit 50

# Комментарии
PYTHONPATH=src python3.11 -m scripts.cli comments list CRM-19
PYTHONPATH=src python3.11 -m scripts.cli comments add CRM-19 "Текст"

# Переходы статусов
PYTHONPATH=src python3.11 -m scripts.cli transitions list CRM-19

# Вложения
PYTHONPATH=src python3.11 -m scripts.cli attachments download CRM-19

Python API

from yatracker_connector import (
    build_tracker_client,
    get_issue,
    add_comment,
    search_issues
)

client = build_tracker_client()
issue = get_issue(client, 'CRM-19')
add_comment(issue, 'Текст комментария')

用于 Claude Code 的 MCP 服务器

通过 Docker 运行并在 .mcp.json 中进行配置:

{
  "mcpServers": {
    "yatracker": {
      "transport": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

MCP 工具

任务操作

  • yatracker_search_issues - 搜索和列出任务

  • yatracker_get_issue - 任务详情

  • yatracker_create_issue - 创建任务/线索

  • yatracker_update_issue - 更新字段

评论

  • yatracker_list_comments - 评论列表

  • yatracker_add_comment - 添加评论

  • yatracker_add_comment_with_attachment - 带附件的评论

转换与状态

  • yatracker_list_transitions - 可用的转换

  • yatracker_execute_transition - 执行转换

附件

  • yatracker_download_attachments - 下载附件

  • yatracker_attach_file - 上传附件

元数据

  • yatracker_list_queues - 队列列表

  • yatracker_list_queue_fields - 队列字段

  • yatracker_list_all_fields - 系统所有字段

  • yatracker_list_queue_issue_types - 任务类型

  • yatracker_get_queue_workflows - 业务流程/状态图

🤝 团队协作

将项目移交给同事 (Docker):

# 1. Коллега клонирует репозиторий
git clone <url>
cd "YaTracker Connector"

# 2. Создает свой .env
cp config/sample.env .env
# Добавляет свои credentials

# 3. Запускает
docker-compose up -d

就是这样! 无需配置路径、Python 版本等。

🔐 配置

在项目根目录下创建 .env 文件:

YATRACKER_TOKEN=your_oauth_token_here
YATRACKER_ORG_ID=your_organization_id
# опционально, если ведёшь учёт приложения: YATRACKER_OAUTH_CLIENT_ID=...

如何获取凭据:

  1. OAuth 令牌:Yandex OAuth

  2. 组织 ID:在 Tracker 中 → 管理 → 组织 → 标识符

  3. 客户端 ID(可选):在同一个 OAuth 后台 — 应用程序标识符;调用 Tracker API 仅需令牌即可

📦 项目结构

.
├── Dockerfile              # Docker образ
├── docker-compose.yml      # Простой запуск
├── .env                    # Credentials (НЕ коммитить!)
├── src/yatracker_connector/
│   ├── config.py          # Настройки
│   ├── client.py          # Клиент API
│   └── operations.py      # Операции с задачами
└── scripts/
    ├── cli.py             # CLI интерфейс
    └── mcp_server.py      # MCP сервер

可用队列

  • CRM - Lead (线索和客户)

  • DEV - 开发

  • MGT - 管理

  • ISTRA - Istra

  • ISTRATEST - Istratest

  • ISTR - Istra

要求

  • Python 3.11+

  • Yandex Tracker API 令牌

  • 组织 ID

许可证

MIT

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
      Enables AI assistants to interact with Yandex.Tracker task management system through MCP protocol. Supports creating and managing issues, searching tasks, handling comments, managing projects and queues, and generating analytics reports.
      ISC
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to read and manage issues, comments, checklists, worklogs, queues, users, metadata, and time reports through the Yandex Tracker REST API v3, requiring user confirmation before data-changing operations.
      30
      MIT