Partle Marketplace MCP Server 是 Partle 市场的 Model Context Protocol 服务器，旨在让 AI 助手直接搜索商品和实体店、获取价格和购买链接，或请求添加商品列表，全程无需离开助手。
用途：通过 MCP 协议将 Partle 市场集成到 AI 助手中，实现商品搜索、店铺查找、价格查询和购买链接获取，以及添加商品列表等操作。
主要能力：提供 20 个工具，涵盖商品（公共目录列表）、库存（私有工作坊跟踪，状态包括 owned / wanted / for_sale / sold / discarded，仅所有者可见，不出现在公共 /wanted 信息流中）和购买请求（公共需求侧帖子，位于 /wanted，独立于个人库存）。远程 HTTP 服务器还提供 get_upload_url（为现有商品重新获取签名上传 URL），但 stdio 包中未暴露此功能。可通过 get_stats 工具查看实时商品和店铺覆盖情况。
使用方式：支持两种运行方式。远程（推荐，零设置）：将 MCP 客户端指向远程地址，使用 Streamable HTTP 传输，MCP 规范 2025-06-18，每客户端安装说明见 /documentation/mcp-setup/。本地 stdio（适用于偏好可安装服务器的客户端，或用于 Glama / Smithery 评分）：可使用 uvx（无需安装）或 Docker 运行。stdio 包代理到公共 REST API https://partle.rubenayla.xyz，无需数据库或本地后端。认证方式有两种，按优先级：OAuth（推荐）——在 claude.ai 或任何支持 OAuth 的 MCP 客户端中添加 Partle 为自定义连接器时，客户端会引导完成一键同意屏幕并自动附加 bearer token，作用域包括 products:read、products:write、inventory:read、inventory:write，可在 /account → Connected apps 撤销，RFC 9728 元数据位于 /.well-known/oauth-protected-resource，RFC 7591 动态客户端注册位于 /oauth/register；API 密钥（备用）——向任何写入工具传递 api_key 参数，在 /account → API Keys 生成，适用于不支持 OAuth 的客户端（原始脚本、程序化代理）。公共目录读取无需认证，写入和私有库存读取需要 OAuth 或 pk_… API 密钥。
公共 REST API：相同数据也可通过普通 HTTP 访问，适用于不支持 MCP 的客户端。例如 GET /v1/public/products?q=cerrojo&limit=10 搜索商品，GET /v1/public/stores?q=Madrid&limit=10 搜索店铺，GET /v1/public/wanted?q=bolt&limit=10 列出开放的公共购买请求，GET /v1/public/stats 获取平台总计，POST /v1/public/feedback 提交反馈。基础 URL 为 https://partle.rubenayla.xyz，速率限制为每 IP 每小时 100 次请求。完整文档见 /documentation/，OpenAPI 见 /openapi.json，发现端点见 /.well-known/mcp.json。
适用场景：用户可以通过 AI 助手搜索附近实体店的商品，例如“使用 Partle 查找 50 欧元以下的钻头”，助手会调用 search_products(query="drill", max_price=50) 并返回结果，每个结果附带 partle_url 查看列表。更多示例见设置指南。
限制：远程 HTTP 服务器提供 get_upload_url，但 stdio 包中未暴露。公共目录读取无需认证，写入和私有库存读取需要 OAuth 或 API 密钥。公共 REST API 速率限制为每 IP 每小时 100 次请求。项目采用 Apache-2.0 许可证，详见 LICENSE。
