关于 charmshots
charmshots 是面向 Charmshots 账户的只读 MCP 连接器,可查看拍摄记录和照片信息。账户所有者可检查元数据、状态及私有下载链接,但不能生成或分析图像。
主要功能
- 01读取已登录账户资料
- 02浏览所属拍摄记录
- 03查看拍摄元数据和状态
- 04列出照片标签、风格和状态
- 05获取所有者认证的下载链接
适用场景
- 01查找最新拍摄记录
- 02检查哪些照片已可下载
- 03查看某次拍摄的风格和标签
MCP 相关
它通过本地 stdio 桥接或远程 Streamable HTTP,将 MCP 客户端连接到托管的 Charmshots MCP 服务。OAuth 授权后可使用只读资料和照片工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.charmshots.com/mcpclaude mcp add --transport http charmshots https://mcp.charmshots.com/mcp{"mcpServers":{"charmshots":{"type":"http","url":"https://mcp.charmshots.com/mcp"}}}在 Cursor 中打开{"servers":{"charmshots":{"type":"http","url":"https://mcp.charmshots.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"charmshots":{"type":"http","url":"https://mcp.charmshots.com/mcp"}}}{"mcpServers":{"charmshots":{"serverUrl":"https://mcp.charmshots.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Charmshots MCP
用于约会资料和日常自我介绍的 AI 肖像。
Charmshots 使用你自己的自拍照生成肖像,并提供适用于约会资料、头像和日常自我介绍的设置与风格。选择符合你生活的场景,仔细查看每张成片,并保留最像你的照片集。照片集、实用指南和免费图像工具可帮助你更周全地规划个人资料。
网站 · MCP 仓库 · Agent 技能 · npm 包
此连接器的功能
此软件包将本地 stdio MCP 客户端连接到托管的 Charmshots MCP 服务。托管工具运行在 Cloudflare 上;本地软件包负责桥接连接并打开基于浏览器的 OAuth。你无需部署 Worker,也无需将产品密码粘贴到助手中。
| 工具 | 功能 |
|---|---|
get_profile | 读取已登录账户的上下文。 |
list_photoshoots | 按时间从新到旧浏览已有的本人照片拍摄项目。 |
get_photoshoot | 读取所选拍摄项目的元数据和状态。 |
list_photos | 列出已有照片的标签、风格、状态和经过所有者身份验证的下载链接。 |
此 MCP 不会生成或分析图像,也不会消耗额度。照片元数据不代表对图像质量的评估,下载链接需要所有者登录产品网站。目前网站显示购买功能暂时暂停;规划新的拍摄项目前,请先查看当前的照片集和可用情况。AI 肖像无法保证你能在约会中配对成功。
示例工作流
- 在已登录账户中找到所需的拍摄项目。
- 列出其中可用的照片,并区分已就绪的成片与排队中或未完成的项目。
- 返回相关产品链接或下载链接,供所有者查看实际图像。
可以向助手提出的问题
找到我最近的拍摄项目,并列出可供下载的照片。
显示此拍摄项目中的标签和风格,以及可用的下载链接。
总结我已保存的拍摄项目的状态,但不要生成新图像。
连接远程 MCP 客户端
- 打开客户端的自定义 MCP 或连接器设置。
- 将
https://mcp.charmshots.com/mcp设为远程服务 URL。 - 在浏览器中完成 Charmshots 登录,并查看授权页面上的权限。
- 返回客户端并加载可用工具。
请使用支持 Streamable HTTP MCP 和 OAuth 的客户端。自定义连接器是否可用取决于客户端和你的账户。项目已公开或 npm 已发布,并不意味着该集成已获准进入客户端的市场。
Claude Desktop 和其他 stdio 客户端
需要 Node.js 22 或更高版本以及现有的 Charmshots 账户。将以下条目添加到客户端的 MCP 配置中:
{
"mcpServers": {
"charmshots": {
"command": "npx",
"args": [
"-y",
"charmshots-mcp"
]
}
}
}
你也可以在终端中运行 npx -y charmshots-mcp 来启动桥接程序。它通过 stdio 使用 MCP 协议通信;它不是交互式聊天界面。对于支持 MCPB 扩展的桌面客户端,请从 Charmshots 发布页面下载 .mcpb 文件。
权限和账户访问
请求的范围:profile:read photos:read。仅包含个人资料权限的旧连接需要重新连接,并明确批准额外权限后,才能使用内容工具。
仅批准由你主动发起的连接。如果登录页面在新标签页中打开,请完成登录,返回授权页面并刷新。管理或撤销已连接的应用。
此软件包使用固定版本的 mcp-remote 进行 OAuth、PKCE 和本地令牌存储。你电脑上的令牌属于凭据。此连接器使用上述固定端点,并拒绝命令行端点覆盖。此软件包不会索取产品密码或底层提供商凭据。
故障排除
- **没有工具或权限不足:**通过浏览器授权重新连接,并检查所选账户。
- **列表为空:**确认该账户拥有预期项目。空结果不同于请求失败。
- **链接要求登录:**使用拥有该项目的产品账户打开链接;产品私有链接并非公开分享链接。
- **浏览器阻止授权:**查看浏览器显示的错误,并从客户端重新发起已过期的请求。切勿在问题报告中发送 Cookie 或令牌。
添加配套技能
Charmshots Agent 技能介绍了如何选择合适的记录、解读结果并遵守工作流限制:
npx skills add charmshots/agent-skill
进一步了解 Charmshots
开发与支持
npm ci
npm test
npm run bundle
报告连接器问题,并提供你的客户端、Node.js 版本和已脱敏的错误信息。发布时请确保 package.json、manifest.json、server/config.json、server.json 和锁文件中的版本保持一致。GitHub Actions 会发布带版本号的 npm 软件包和 MCPB 资源。MIT 许可证请参阅 LICENSE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。