PicYep MCP 开发者指南

PicYep 是一个远程 Model Context Protocol 服务器。用户把它连接到自己的助手一次，助手就能用这个账号生成照片和视频。不需要模型服务商的密钥，生成内容花的是用户自己的点数。

服务器

• 地址：https://picyep.com/mcp
• ChatGPT 专用：https://picyep.com/mcp/chatgpt
• 传输方式：Streamable HTTP，无状态，以 JSON 回答
• 登录：OAuth 2.1，带 PKCE 和动态客户端注册

可以读的文件

• developers.md：所有工具的 Markdown 说明
• auth.md：登录的每一步
• openapi.json
• .well-known/mcp.json：服务器卡片
• pricing.md：价格和点数
• status.json

授权范围

• photos：查看余额和模型，用账号的点数生成照片，使用通过链接添加的照片。
• library：查看、修改和删除保存的照片、人物和相册，并为照片生成公开链接。
• offline_access：刷新令牌。

添加照片

聊天里的附件传不到连接器，所以 create_upload_link 会生成一个手机和电脑都能打开的链接；在支持 MCP Apps 的客户端里，还会在聊天中显示上传框。check_upload 可以等待照片到达。能自己发送文件的客户端，可以把每个文件作为原始请求体 POST 到 post_to 地址。在 ChatGPT 地址上，add_chat_photos 接收附到聊天里的照片。

任务和点数

生成照片或视频都是一个任务。工具返回 job_id，结果好了之后用 check_job 取。estimate_cost 和 estimate_video_cost 会先告诉你要花多少点数。用同一个 request_id 重发不会重复扣费，没有出结果的请求会退还点数。

连接客户端

见连接方法。