Skip to main content
Glama
deenesjakoruzh
Belkin-digital

YaTracker Connector

by Belkin-digital
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

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 Server

📚 文档

🔧 功能

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

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • YouTrack MCP Server

    devstroop
    F
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI assistants to interact with JetBrains YouTrack 2025.2 for managing issues, sprints, dependencies, time tracking, and knowledge base content. Supports CRUD operations, bulk commands, analytics with Gantt charts and critical path analysis, and covers ~80% of the YouTrack REST API.
    24
    52
    -

  • Yandex Tracker MCP Server

    zolkinka
    F
    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.
    -

  • yandex-tracker-mcp

    brekhov-ilya
    A
    license
    Not graded
    quality
    C
    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.
    48
    1
    MIT