关于 GemstoneAI
GemstoneAI 是托管式 MCP 服务,供助手根据照片识别和研究珠宝。它提供初步分析、带照片的市场可比信息,并可将珠宝保存到用户的收藏中。
主要功能
- 01分析 1–5 张珠宝照片
- 02查看可比挂牌与成交记录
- 03将珠宝保存到收藏
- 04列出识别选项与未知信息
适用场景
- 01根据照片研究已有珠宝
- 02将珠宝与带照片的市场案例比较
- 03保存分析结果以便在应用中查看
MCP 相关
向 MCP 客户端提供珠宝分析、分析状态查询、可比信息搜索和收藏保存工具。它作为远程 Streamable HTTP 服务连接,并通过 OAuth 登录。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.gemstoneaiapp.com/mcpclaude mcp add --transport http com-gemstoneaiapp-gemstoneai https://api.gemstoneaiapp.com/mcp{"mcpServers":{"com-gemstoneaiapp-gemstoneai":{"type":"http","url":"https://api.gemstoneaiapp.com/mcp"}}}在 Cursor 中打开{"servers":{"com-gemstoneaiapp-gemstoneai":{"type":"http","url":"https://api.gemstoneaiapp.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-gemstoneaiapp-gemstoneai":{"type":"http","url":"https://api.gemstoneaiapp.com/mcp"}}}{"mcpServers":{"com-gemstoneaiapp-gemstoneai":{"serverUrl":"https://api.gemstoneaiapp.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
面向 Agent 的 GemstoneAI
GemstoneAI 是一个托管的远程 MCP 服务,可让 AI 助手帮助用户了解自己拥有的一件珠宝。助手可以:
- 分析这件珠宝的 1 到 5 张照片,并给出初步鉴定结果,包括可能的其他判断、未知信息,以及可以确认这些判断的证据
- 展示有照片的可比商品刊登信息和成交记录,并标明每条是要价还是实际成交价
- 将这件珠宝保存到用户的 GemstoneAI 收藏中,以便在用户手机上的 GemstoneAI 应用中打开
https://api.gemstoneaiapp.com/mcp
无需安装或运行任何内容。产品页面:gemstoneaiapp.com/agents。
连接
在任何支持远程 MCP 服务的客户端中,将该 URL 添加为远程(Streamable HTTP)MCP 服务。客户端会自行发现登录流程。用户使用其 GemstoneAI 应用所用的邮箱登录,因此收藏内容保持一致;使用新邮箱则会获得一个免费账户。每次新分析都会消耗该账户套餐中的一次扫描额度,与应用中的规则相同。
Claude Code,以插件形式(添加服务和珠宝研究技能):
/plugin marketplace add Iveye-Inc/gemstoneai-agents
/plugin install gemstoneai@gemstoneai
Claude Code,仅添加服务:
claude mcp add --transport http gemstoneai https://api.gemstoneaiapp.com/mcp
然后在 Claude Code 中运行 /mcp 登录。
其他客户端(Claude 网页版和桌面版、ChatGPT 开发者模式、Cursor、VS Code、MCP Inspector):使用上述 URL 添加远程 MCP 服务,并在出现提示时登录。
产品页面列出了客户端支持情况。只有在某个客户端中完整通过了整个流程(照片、分析、可比项、保存、在应用中重新打开)后,才会将其标记为已测试。
工具
| 工具 | 功能 | 注解 |
|---|---|---|
analyze_jewelry | 对一件珠宝的 1 到 5 张照片进行初步分析。接收 photos(附加文件)或 image_urls(公开的 https URL),以及可选的 idempotency_key。如果没有照片,则返回一个上传链接,供用户在手机上打开。 | 写入、非破坏性、幂等、开放世界 |
get_jewelry_analysis | 获取分析状态或已完成的结果。分析处理中时最多等待约 40 秒。 | 只读 |
find_jewelry_comparables | 返回有照片的市场商品刊登信息和成交记录,包括来源、链接、价格、价格类型、发现日期,以及与这件珠宝的材质差异。 | 只读、开放世界 |
save_collection_item | 将已分析的珠宝保存到已登录用户的收藏中,并返回一个可在应用中打开该珠宝的链接。 | 写入、非破坏性、幂等 |
结果不会包含数值置信度。不确定性会以其他可能性、未知信息和后续所需证据的形式呈现。如果 GemstoneAI 自身的判断对宝石种类存在分歧,则会说明原因并暂不提供价格背景。如果没有找到有价格的可比项,回答会是“未找到”,绝不会给出零值。
协议与身份验证
- Streamable HTTP,无状态,JSON 响应。支持基于 Initialize 的客户端(协议版本 2024-11-05 至 2025-11-25)和 2026-07-28 客户端。
- 使用 OAuth 2.1 和 PKCE(S256)。发现地址:
api.gemstoneaiapp.com上的/.well-known/oauth-protected-resource/mcp和/.well-known/oauth-authorization-server。 - 客户端通过 Client ID Metadata Documents 或动态客户端注册进行注册。回环重定向可使用任意端口。
- 令牌绑定到一位用户、一个客户端和此服务(RFC 8707)。访问令牌有效期为一小时;刷新令牌会轮换。
- 权限范围:
jewelry:analyze和collection:write。
延迟与限制
- 分析通常需要 20 到 45 秒。
analyze_jewelry最多等待约 40 秒,之后会返回processing状态及重试间隔。可比项通常会在一分钟内出现。 - 重复提交相同照片,或使用相同的
idempotency_key,都会返回相同的分析结果,且不会重复扣费。 - 试点期间,每个账户和每项集成都有每日评估次数限制。开发者可在产品页面申请试点访问权限。
它不是什么
结果是基于照片得出的初步分析,不构成估价,也无法确定真伪、处理情况、来源或认证价值。该服务从不买卖、发布商品或联系任何人,且仅在用户提出请求时才会将内容保存到收藏集。
隐私
照片用于分析物品,并与物品一起保存在用户的 GemstoneAI 账户中,就像应用中的扫描件一样。每张照片都会移除位置数据。请参阅隐私政策和条款。
仓库结构
.claude-plugin/marketplace.json、plugins/gemstoneai/:Claude Code 插件(MCP 服务配置和珠宝研究技能)openai/:ChatGPT 插件包源代码;运行python scripts/build_openai_zip.py可构建 ZIP 文件server.json:官方 MCP 注册表中的条目,通过scripts/publish_registry.py发布
支持
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。