put.io MCP

Приватный TypeScript MCP-сервис для разговорного управления авторизованным контентом в одном аккаунте put.io.

Репозиторий находится на этапе предварительного планирования и снижения рисков. Он пока не предоставляет работающих MCP-инструментов, не аутентифицирует ChatGPT и не изменяет put.io.

Локальная настройка

Требования:

• Node.js 24.19.0 или новее

• pnpm 11.19.0

pnpm install --frozen-lockfile
cp .env.example .dev.vars
pnpm dev

Локальная конечная точка здоровья — http://localhost:8787/health. Конечная точка Streamable HTTP MCP — http://localhost:8787/mcp. Во время транспортного спайка она предоставляет только get_storage, который безопасно возвращает PUTIO_UNCONFIGURED без учётных данных put.io или живого API-запроса.

Проверка

pnpm lint
pnpm typecheck
pnpm test
pnpm test:contract
pnpm build
pnpm build:sdk-spike

Никогда не коммитьте .dev.vars, токены, OAuth-коды, сырые магнет-ссылки, URL релизов, данные аккаунта или реальные имена медиафайлов.

См. AGENTS.md, docs/STATUS.md и docs/threat-model.md перед изменением поведения.