Partle

Partle Marketplace MCP 服务

Model Context Protocol 服务，适用于 Partle Marketplace——让你的 AI 在这里购物：搜索商品和商店、获取价格和购买链接，或让它帮你添加商品信息，整个过程无需离开助手。

通过 get_stats 工具即可查看实时商品和商店覆盖情况。读取公开目录无需身份验证。写入数据和读取私有库存需要 OAuth 或 pk_… API 密钥。

两种运行方式

远程（推荐——零配置）

将 MCP 客户端指向：

https://partle.rubenayla.xyz/mcp/

就这样。使用 Streamable HTTP 传输，符合 MCP 规范 2025-06-18。各客户端的安装说明：/documentation/mcp-setup/。

本地 stdio（适用于偏好可安装服务的客户端，或用于 Glama / Smithery 评分）

pip install partle-mcp
partle-mcp

或者使用 uvx（无需安装）：

uvx partle-mcp

也可以使用 Docker：

docker run --rm -i ghcr.io/rubenayla/partle-mcp

stdio 软件包会代理到公开 REST API https://partle.rubenayla.xyz，因此无需数据库或本地后端。

Claude Desktop / Claude Code（stdio）

{
  "mcpServers": {
    "partle": {
      "command": "uvx",
      "args": ["partle-mcp"]
    }
  }
}

工具（共 20 个）

读取（无需身份验证）

工具	用途
search_products	按名称、价格范围、标签和商店搜索目录。支持跨语言语义搜索。
get_product	根据 ID 获取单个商品的完整记录。
search_stores	按名称或地址搜索／列出商店。
get_store	根据 ID 获取单个商店的完整记录。
get_stats	平台整体统计数据。
search_wanted	浏览 /wanted 上公开的求购请求——人们想买但尚未找到的商品。可与 search_products 交叉比对，以提供匹配商品。

写入（已认证）

有两种认证方式，按推荐顺序排列：

1. OAuth（推荐） — 将 Partle 添加为 claude.ai 或任何支持 OAuth 的 MCP 客户端中的自定义连接器时，客户端会引导你完成一键授权页面，并自动附加持有者令牌。作用域：products:read、products:write、inventory:read、inventory:write。前往 /account → 已连接的应用撤销授权。RFC 9728 元数据位于 /.well-known/oauth-protected-resource；RFC 7591 动态客户端注册位于 /oauth/register。
2. API 密钥（备用） — 将 api_key 参数传递给任何写入工具。前往 /account → API 密钥生成密钥。当你的客户端不支持 OAuth 时（原始脚本、编程式 Agent），请使用此方式。

产品 — 公开目录商品。

工具	用途
create_product	添加新商品。若 AI 代表尚未确认的用户提出商品，请设置 verified=false。
update_product	编辑你拥有的商品。
delete_product	移除你拥有的商品。
upload_product_image	附加图片（base64 或 URL）。
delete_product_image	从商品中移除图片。
get_my_products	列出你创建的商品。

远程 HTTP 服务还提供 get_upload_url（为现有商品重新获取已签名的上传 URL）。此工具未在此 stdio 软件包中公开 — 如有需要，请使用远程服务。

库存 — 私人工作室库存跟踪（owned / wanted / for_sale / sold / discarded）。仅所有者可见；不会显示在公开的 /wanted 信息流中。

工具	用途
get_my_inventory	列出你的库存项。可按状态、项目和自由文本筛选。
add_inventory_item	添加处于任意生命周期状态的条目。
update_inventory_item	更新任意字段。
delete_inventory_item	永久移除条目。
mark_for_sale	便捷工具：将 owned 商品改为 for_sale，并设置要价。
mark_sold	便捷工具：将 for_sale 商品改为 sold。

求购请求 — /wanted 上的公开需求帖，与个人库存相互独立。

工具	用途
create_buy_request	发布公开求购请求（名称、描述、数量，以及可选的 max_price 和 contact）。

反馈

工具	用途
submit_feedback	发送关于集成体验的自由格式反馈。

公共 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。

示例

你：“使用 Partle 查找 €50 以下的电钻。”

Claude： （调用 search_products(query="drill", max_price=50)）

返回 Blackspur 13pc High Speed Drill Bit Set，价格为 €4.99（Lenehans，IE）；Flotec Drill Pump 225 GPH，价格为 €17.14（Kooyman Megastore，NL）；以及其他几款商品 — 每款都附有可查看商品详情的 partle_url。

更多示例请参阅设置指南。

许可证

Apache-2.0 — 参见 LICENSE。