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 сервер работает на порту 8080Docker 的优势:
✅ 无需绝对路径
✅ 在任何地方运行效果一致
✅ 易于与同事共享
✅ 不会与其他项目冲突
📖 详情请见: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
📚 文档
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-19Python 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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Task manager your agent can fully operate: boards, tasks, sprints, roles, worklogs, day planner.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Read and update tickets, deals, tasks, and contacts in 18 Cores Tracker.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Yandex Tracker tasks with tools for creating, reading, updating, and transitioning issues via a Streamable HTTP endpoint.-
- AlicenseAqualityBmaintenanceEnables AI assistants to securely interact with Yandex Tracker, managing issues, queues, comments, worklogs, and search, including attaching files to issues.561Apache 2.0
- AlicenseBqualityCmaintenanceEnables 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.30MIT