mcpField
P
Pearl

Pearl

远程服务
joinpearl.co地图与出行12 周前更新
代码仓库访问官网

关于 Pearl

Pearl 为符合资格的 Reserve 和 Elite 会员提供旅行地点发现、桌位空位查询及已确认的访问、收藏和私人行程操作。它通过面向多个主机的集成包连接同一经过认证的 MCP 端点；当前不支持预订或更改预订。

主要功能

  1. 01发现地点并查看详情
  2. 02查询桌位空位与开放时间
  3. 03查找相似地点、附近地点和活动
  4. 04创建访问记录、收藏地点和私人行程
  5. 05按连接权限开放操作

适用场景

  1. 01探索目的地并比较附近地点
  2. 02查看地点详情和订位开放时间
  3. 03记录访问并保存地点
  4. 04整理私人旅行行程

MCP 相关

该集成包将支持的主机连接到 Pearl 的 Streamable HTTP MCP 端点 https://agent.joinpearl.co/mcp。可用工具取决于客户端及连接权限；此版本不提供预订、保留、修改、取消或付款功能。

配置

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

服务地址https://agent.joinpearl.co/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 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Pearl Agent 集成包

刚开始使用 Pearl？请从快速入门与测试指南开始。

符合条件的 Pearl Reserve 和 Elite 会员可以连接。可用操作取决于连接权限和实时工具清单。

Pearl 的可安装包为 Codex、Claude、Cursor 和 Cursor 的 Grok Bot 提供轻量级宿主集成，用于连接一个经过身份验证的 Streamable HTTP MCP 端点：

https://agent.joinpearl.co/mcp

该包包含宿主清单、Pearl Concierge 技能、公开设置文档、品牌素材、仅用于展示的 MCP Apps 资源和验证代码。不包含应用、数据库、OAuth 服务、MCP 执行器、部署配置、访问令牌或客户端密钥。

当前版本

包 0.12.7 为每个经过身份验证的连接保留通用的 13 项读取功能。经过审查的 Codex、Claude 和 Cursor 客户端还可使用桌位可用性、六项发现类读取功能（场所详情、预订开放时间、相似和附近场所、Pearl 活动，以及某个 Tables 城市中可预订的场所），以及十项用于到访、已保存场所和私人旅行的确认操作工具：启用七项读取功能时共有 20 项工具，启用全部十种权限范围时共有 30 项工具。发现类读取功能无需新增权限；只需重新连接以批准保存和旅行相关权限。ChatGPT 保留其已提交的 18 项到访／可用性功能约定。独立的 Pearl CLI 和未知客户端在通用的 13 项读取功能下仍为只读。

当前版本的 Codex 使用由 OpenAI 托管的共享 CIMD 客户端 ID（旧版本使用每次安装各自的身份）；Pearl 仅接受经过严格验证的官方客户端系列。所有宿主共用同一个网关和执行器。卡片仅用于展示，涵盖场所、已保存场所、到访、场所匹配结果、你的个人资料、旅行、预订、场所详情、可用性、航班（如有），以及到访／保存／旅行的预览和回执。

有关准确的宿主矩阵和如实标注的不可用工作流，请参阅功能快照。本版本中，没有任何宿主可以预订、保留、更改或取消预订，也不能付款。此软件包不会声称任何宿主已获批准或已列出 Pearl。

有关实用的记录／编辑提示词、匹配和确认规则，以及 预订限制，请参阅到访与预订。

包含的构件

  • .codex-plugin/plugin.json：Codex 元数据和入门提示词。
  • .claude-plugin/plugin.json：Claude Code 和 Cowork 元数据。
  • cursor/.cursor-plugin/plugin.json：独立的 Cursor 源，以及宿主专用的 pearl-cursor 标识符和无需密钥的公开 OAuth 配置。
  • .mcp.json：Codex 和 Claude 共用的单一 URL 连接；Cursor 的独立轻量封装使用同一端点，并采用其必需的静态公开客户端。
  • server.json：同一远程 URL 的 MCP Registry 预览条目；不包含标头、凭据、软件包运行时或工具清单。
  • skills/pearl-concierge/：面向 Codex 和 Claude 的规范化发现优先工作流技能；Cursor 在其独立源子目录中附带了经过逐字节验证的镜像。
  • docs/：会员设置、宿主注册与审核、OAuth 和发布说明。
  • assets/：经批准的 Pearl 市场素材；请参阅 assets/README.md。Cursor 的独立源中包含经过哈希验证的徽标镜像。
  • mcp-apps/：无依赖、带版本的内嵌 UI 资源和集成辅助工具。它不新增工具、身份验证、网络端点或业务逻辑；请参阅 mcp-apps/README.md。
  • scripts/ 和 test/：零依赖验证。

验证

在仓库根目录运行：

npm --prefix plugins/pearl test
npm --prefix plugins/pearl run validate
npm --prefix plugins/pearl run validate:live
npm --prefix plugins/pearl run validate:registry
npm --prefix plugins/pearl run validate:registry:schema
npm --prefix plugins/pearl run validate:registry:live
claude plugin validate plugins/pearl --strict
claude plugin validate . --strict

实时验证仅执行公开发现和未经身份验证的挑战检查。它不会使用凭据或调用成员工具。

安装了 Codex 内置的 plugin-creator 和 skill-creator 技能的 Pearl 维护者，还应使用这些技能的验证器检查 plugins/pearl 和两个打包的 Pearl Concierge 技能目录。这些是维护者检查，不是公开软件包依赖项。

发布到市场之前，还应运行 docs/submission.md 中记录的安全静态主机注册探测。这些探测使用故意无效的 MCP 资源，不会创建授权请求或调用成员工具。

官方 MCP Registry 仍处于预览阶段。将 server.json 保留在软件包中，并不代表已发布，也不意味着获得了 Registry、Anthropic、Cursor 或 OpenAI 的批准。Registry 发布是单独的受保护发布操作，详见 docs/releasing.md。

安全与支持

切勿将凭据、环境文件、授权标头、私有实现细节或成员数据添加到此软件包中。请发送邮件至 [email protected]，并在主题行中添加 [Security]，以私下报告漏洞。

评论

支持 Markdown

第一次接触 MCP？

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

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