PegaRex

PegaRex MCP 服务

面向 PegaRex 的远程模型上下文协议服务——这是巴西的车辆元搜索引擎，汇集了 96 个市场平台（OLX、Webmotors、Napista 等众多平台）上 180 多万条实时二手汽车和摩托车挂牌信息，并提供 FIPE 参考价格和市场分析。

端点（Streamable HTTP）：

https://pegarex.com.br/api/mcp

需要一个免费的 PegaRex 账户。首次使用时，你的应用会打开 PegaRex 页面，让你登录（或创建账户）并授权。这是标准的 MCP 授权方式（OAuth 2.1，支持动态客户端注册），因此无需复制 API 密钥。之后，应用会自动续期访问权限；如果 30 天未使用，则会再次要求授权。

连接

Claude（claude.ai / Desktop）： 设置 → 连接器 → 添加自定义连接器 → 粘贴上方 URL → 连接，然后使用 PegaRex 登录并点击 Permitir。

ChatGPT（开发者模式）以及任何支持 OAuth 的 MCP 客户端： 将同一 URL 添加为远程 MCP 服务（如有提示，请选择 OAuth），并在 PegaRex 页面打开时登录。

如果你在 2026 年 10 月 16 日之前已连接，请重新连接一次：服务器从这天起开始要求提供账户。

分步指南（pt-BR）：https://pegarex.com.br/mcp

也已作为 br.com.pegarex/mcp 列入 官方 MCP 注册表。

本地（stdio）客户端

对于只能启动本地服务的客户端，此仓库包含一个小型桥接程序（src/pegarex_mcp）。它会与托管服务建立一个会话，并原样转发 tools/list 和 tools/call；不会在本地进行计算或缓存。需要 Python 3.10+。

先在终端中登录一次（此操作会打开浏览器），使用 uv：

uvx --from git+https://github.com/paya-alavi77/pegarex-mcp pegarex-mcp login

然后将桥接程序添加到客户端。Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "pegarex": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/paya-alavi77/pegarex-mcp", "pegarex-mcp"]
    }
  }
}

如果跳过 login，桥接程序会在首次连接时自行打开登录页面。有些客户端会在你完成登录前停止等待；如果你的客户端如此，请在登录后重启它。

登录信息保存在 ~/.config/pegarex-mcp/auth.json（Windows： %APPDATA%\pegarex-mcp\auth.json；PEGAREX_MCP_HOME 可指定其他文件夹）中，仅你本人可读取，并会自动续期。多个桥接程序副本可以共用该信息。如需终止登录，请在此处和服务器上执行：

uvx --from git+https://github.com/paya-alavi77/pegarex-mcp pegarex-mcp logout

Docker：容器无法打开浏览器，因此请先在主机上登录（使用上方的 login 命令），然后让容器使用该登录信息：

docker build -t pegarex-mcp .
docker run -i --rm --user "$(id -u):$(id -g)" -e PEGAREX_MCP_HOME=/login \
  -v "$HOME/.config/pegarex-mcp:/login" pegarex-mcp

将 PEGAREX_MCP_URL 设置为其他端点，以便桥接程序连接到该端点。

工具（17）

实时搜索与分类体系 search_vehicles · get_vehicle_by_id · get_market_stats · list_brands · list_models · list_versions · list_filter_options

单条挂牌信息的市场分析 get_listing_details · get_market_position · get_fipe_valuation · get_price_distribution · get_similar_active_listings · get_alternative_models · get_cheapest_states · get_mileage_context · get_avg_days_to_sell · get_technical_specs

示例

“查找 2020 年及之后、售价低于 R$ 120k、位于圣保罗的自动挡 Honda Civic，并告诉我价格最低的一辆高于还是低于其 FIPE 参考价。”

配置此连接器的助手会根据实时数据库作答：搜索 → get_fipe_valuation → get_market_position，整个过程在一次对话中完成。

备注

• 语言 / 市场： 巴西葡萄牙语（pt-BR），巴西。价格以 BRL 计价。
• 只读。 服务不提供写入操作；每个工具均标注 readOnlyHint。
• 合理使用： 每个账户每日搜索次数有限制，且适用每个 IP 的速率限制；这是一个小型独立服务。
• 隐私： 服务会保留哪些信息，以及保留多久：https://pegarex.com.br/privacidade。
• 署名： 展示搜索结果时，请注明来源为 PegaRex (pegarex.com.br)。
• 纯 HTTP 替代方案：相同数据也可通过公开 JSON API 获取，参见 /llms.txt 和 OpenAPI 文档。

本仓库介绍托管服务，并包含一个连接该服务的小型 stdio 桥接程序；服务本身运行于 pegarex.com.br。欢迎在此提交问题和提问。