put.io MCP

用于在单个 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。