Polovnjak MCP

一个用于二手车市场的多提供商 MCP 服务器。智能体获得一个统一工具面——搜索、列表详情、价格统计、价格历史，以及按用户保存的搜索监视——由可插拔的市场适配器支持。内置适配器：polovniautomobili.com（源 id pa）和 mojauto.rs（源 id ma），均位于塞尔维亚。

用户通过标准 MCP OAuth 2.1 流程使用 Google 登录；监视按用户私有。中心观察到的每个列表（来自任何用户的搜索、统计采样或监视检查）都会记录到共享的 Postgres“市场记忆”中，为任何单一市场都无法提供的价格历史和趋势查询提供支持。

架构

• 适配器（src/adapters/）实现通用 SourceAdapter 接口：search、getListing、getMakesModels，以及能力标志。每个适配器将规范过滤器转换为其提供商的查询，并将结果映射回规范列表模型。列表携带复合 id，如 pa:12345678 或 ma:3554254。品牌名称按源进行别名解析（“VW”和“Volkswagen”在任何地方都有效）；源无法表达的过滤器会在结果中报告为按源的 warnings。

• 工具（src/tools/）跨适配器扇出并合并结果，为所有内容标记其来源。类别涵盖汽车、摩托车、厢式货车、轻型/重型卡车、客车、拖车、房车、机械、拖拉机、船只和自行车。

• 记录器（src/recorder.ts）将每个观察到的列表 upsert 到 listings 中，并在首次发现或价格变化时追加一行 price_observations。

• 认证（src/auth/）是一个自托管的 OAuth 2.1 授权服务器（动态客户端注册、PKCE、刷新令牌），以 Google OIDC 作为身份层。令牌以哈希形式存储在 Postgres 中。

• 存储通过 Drizzle ORM 使用 Postgres；迁移在启动时自动运行。

Related MCP server: Vehicle Database MCP Server

快速开始（Docker Compose）

1. 在 Google Cloud Console 创建一个 Google OAuth 客户端（类型“Web application”），授权重定向 URI 为 <PUBLIC_URL>/auth/google/callback（例如本地使用 http://localhost:8321/auth/google/callback）。

2. 配置环境：

cp .env.example .env
# set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET (and PUBLIC_URL for non-local deployments)

3. 启动所有内容（MCP 服务器 + Postgres + FlareSolverr）：

docker compose up -d --build

4. 将 MCP 客户端指向 http://localhost:8321/mcp。客户端将发现 OAuth 元数据、自行注册，并打开浏览器窗口进行 Google 登录。之后的一切都是按用户进行的。

如需在没有 Google 凭据的情况下进行快速本地测试，请设置 AUTH_MODE=none——服务器随后跳过认证并使用单个本地开发用户。

工具

智能体技能

仓库附带一个智能体技能，位于 .cursor/skills/car-market-hub/SKILL.md，教 LLM 智能体如何有效使用此服务器（工具工作流、注意事项），并在 clients.md 中提供针对 OpenAI、Claude、LibreChat 和 Cursor 的按客户端连接指南。Cursor 会自动拾取；对于其他平台，将技能目录复制到该平台的技能位置（例如 .claude/skills/）或将其内容粘贴到智能体的指令中。

监视工作流

1. 使用名称和过滤器（可选地限制为特定 sources）调用 create_watch——当前匹配成为基线。

2. 稍后（例如计划提示：“检查我的汽车监视”），check_watches 仅返回自那时以来出现的列表，按监视和按来源。

添加新的市场适配器

1. 创建 src/adapters/<name>/ 并从 src/adapters/types.ts 实现 SourceAdapter 接口：选择一个简短稳定的 id（用于复合列表 id），将规范 SearchQuery 过滤器转换为您提供商的查询，并将原始结果映射为 src/domain/listing.ts 中的规范 ListingSummary / ListingDetail 形状。

2. 在 src/server.ts 中使用 registerAdapter(...) 注册它。

搜索扇出、监视、记录和价格历史会自动拾取新来源。

环境变量

本地开发

npm install
docker compose up -d postgres        # or point DATABASE_URL at your own Postgres
AUTH_MODE=none npm run dev           # server on http://localhost:8080/mcp

架构更改：编辑 src/db/schema.ts，然后运行 npm run db:generate 在 drizzle/ 下生成新迁移（启动时自动应用）。

注意事项和限制

• polovniautomobili.com 没有公共 API；适配器使用 Chrome TLS 模拟（impit）读取该站点的 Next.js 数据端点，并以 FlareSolverr 作为 Cloudflare 挑战回退。请负责任地使用并遵守站点的服务条款。

• 低于 100 欧元的价格被视为“价格面议”，并从统计和观察中排除。

• 监视检查扫描每个来源的前两个结果页（约 50 条最新列表）。

• get_price_history 仅反映通过此中心观察到的列表——这是一个不断增长的样本，而非完整市场。

• 之前的单提供商实现保留在 old/ 中供参考（不参与构建）。