put.io MCP

1つの put.io アカウント内の認可済みコンテンツを会話形式で管理するためのプライベート TypeScript MCP サービスです。

このリポジトリは実装前の計画段階とリスク解消段階にあります。まだ動作する 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 のみを公開し、put.io の認証情報やライブ API リクエストなしで安全に PUTIO_UNCONFIGURED を返します。

検証

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 を参照してください。