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

📚 文档

QUICKSTART.md - CLI 命令快速参考
CLAUDE.md - 项目使用完整指南
DOCKER.md - 通过 Docker 部署

🔧 功能

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=...

如何获取凭据：

OAuth 令牌：Yandex OAuth
组织 ID：在 Tracker 中 → 管理 → 组织 → 标识符
客户端 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

YaTracker Connector

YaTracker 连接器

🚀 快速开始

选项 1：Docker（推荐）

选项 2：本地安装

📚 文档

🔧 功能

CLI (命令行界面)

Python API

用于 Claude Code 的 MCP 服务器

MCP 工具

任务操作

评论

转换与状态

附件

元数据

🤝 团队协作

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

🔐 配置

如何获取凭据：

📦 项目结构

可用队列

要求

许可证

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API