mcpField
C
charmshots

charmshots

远程服务
github.com/charmshots媒体与设计03 周前更新
代码仓库

关于 charmshots

charmshots 是面向 Charmshots 账户的只读 MCP 连接器,可查看拍摄记录和照片信息。账户所有者可检查元数据、状态及私有下载链接,但不能生成或分析图像。

主要功能

  1. 01读取已登录账户资料
  2. 02浏览所属拍摄记录
  3. 03查看拍摄元数据和状态
  4. 04列出照片标签、风格和状态
  5. 05获取所有者认证的下载链接

适用场景

  1. 01查找最新拍摄记录
  2. 02检查哪些照片已可下载
  3. 03查看某次拍摄的风格和标签

MCP 相关

它通过本地 stdio 桥接或远程 Streamable HTTP,将 MCP 客户端连接到托管的 Charmshots MCP 服务。OAuth 授权后可使用只读资料和照片工具。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://mcp.charmshots.com/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包
npmcharmshots-mcp1.2.1

工具

详细介绍

Charmshots MCP

用于约会资料和日常自我介绍的 AI 肖像。

Charmshots 使用你自己的自拍照生成肖像,并提供适用于约会资料、头像和日常自我介绍的设置与风格。选择符合你生活的场景,仔细查看每张成片,并保留最像你的照片集。照片集、实用指南和免费图像工具可帮助你更周全地规划个人资料。

网站 · MCP 仓库 · Agent 技能 · npm 包

此连接器的功能

此软件包将本地 stdio MCP 客户端连接到托管的 Charmshots MCP 服务。托管工具运行在 Cloudflare 上;本地软件包负责桥接连接并打开基于浏览器的 OAuth。你无需部署 Worker,也无需将产品密码粘贴到助手中。

工具功能
get_profile读取已登录账户的上下文。
list_photoshoots按时间从新到旧浏览已有的本人照片拍摄项目。
get_photoshoot读取所选拍摄项目的元数据和状态。
list_photos列出已有照片的标签、风格、状态和经过所有者身份验证的下载链接。

此 MCP 不会生成或分析图像,也不会消耗额度。照片元数据不代表对图像质量的评估,下载链接需要所有者登录产品网站。目前网站显示购买功能暂时暂停;规划新的拍摄项目前,请先查看当前的照片集和可用情况。AI 肖像无法保证你能在约会中配对成功。

示例工作流

  1. 在已登录账户中找到所需的拍摄项目。
  2. 列出其中可用的照片,并区分已就绪的成片与排队中或未完成的项目。
  3. 返回相关产品链接或下载链接,供所有者查看实际图像。
可以向助手提出的问题

找到我最近的拍摄项目,并列出可供下载的照片。

显示此拍摄项目中的标签和风格,以及可用的下载链接。

总结我已保存的拍摄项目的状态,但不要生成新图像。

连接远程 MCP 客户端

  1. 打开客户端的自定义 MCP 或连接器设置。
  2. 将 https://mcp.charmshots.com/mcp 设为远程服务 URL。
  3. 在浏览器中完成 Charmshots 登录,并查看授权页面上的权限。
  4. 返回客户端并加载可用工具。

请使用支持 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。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。