Partle Marketplace MCP服务器
模型上下文协议 Partle本地市场的服务器——在你附近的实体店找到产品，让人工智能为你添加一个列表，所有这些都不需要离开你的助手。
130000+产品 穿过 约16000家门店读取不需要身份验证。写作需要a pk_… API密钥。
运行它的两种方法
远程（推荐——零设置）
将您的MCP客户端指向：
https://partle.rubenayla.xyz/mcp/就是这样。流式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-mcpstdio包代理位于的公共REST API https://partle.rubenayla.xyz，因此您不需要数据库或本地后端。
克劳德桌面/克劳德代码（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 提供比赛。 |
写入（已验证）
两种身份验证方式，按优先顺序排列：
- OAuth（推荐） --当您在claude.ai或任何支持OAuth的MCP客户端中将Partle添加为自定义连接器时，客户端会引导您通过一键同意屏幕，并自动附加承载令牌。范围：
products:read,products:write,inventory:read,inventory:write.撤销 账户 → 已连接的应用程序RFC 9728元数据位于/.well-known/oauth-protected-resource；RFC 7591动态客户端注册/oauth/register. - API密钥（回退） --通过A
api_key任何写入工具的参数。生成时间 账户 → API密钥。当您的客户端不支持OAuth（原始脚本、编程代理）时，请使用此选项。
产品 --公共目录列表。
| 工具 | 目的 |
|---|---|
create_product | 添加新列表。集 verified=false 当人工智能代表未经证实的人类提出建议时。 |
update_product | 编辑您拥有的列表。 |
delete_product | 删除您拥有的列表。 |
upload_product_image | 附加图像（base64或URL）。 |
delete_product_image | 从产品中删除图像。 |
get_my_products | 列出您创建的产品。 |
远程HTTP服务器还提供 get_upload_url （重新获取现有产品的签名上传URL）。未在此stdio包中公开——如果需要，请使用远程服务器。库存 --私人车间跟踪（拥有/想要/出售/出售/丢弃）。业主私有； 不 出现在公众面前 /wanted 饲料。
| 工具 | 目的 |
|---|---|
get_my_inventory | 列出您的库存物品。可按状态、项目、自由文本进行筛选。 |
add_inventory_item | 在任何生命周期状态中添加一行。 |
update_inventory_item | 修补任何字段。 |
delete_inventory_item | 永久删除一行。 |
mark_for_sale | 方便：翻转 owned 项目到 for_sale 并设定要价。 |
mark_sold | 方便：翻转a for_sale 项目到 sold. |
购买请求 --公众需求侧帖子 /wanted独立于个人库存。
| 工具 | 目的 |
|---|---|
create_buy_request | 发布公开购买请求（标题、描述、数量、可选 max_price 和 contact). |
反馈
| 工具 | 目的 |
|---|---|
submit_feedback | 发送有关集成体验的自由反馈。 |
公共REST API
相同的数据，对于不支持MCP的客户端，也可以作为普通HTTP访问：
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欧元以下的钻头。” 克劳德： *（电话search_products(query="drill", max_price=50))* 退回Blackspur 13pc高速钻头套装，售价4.99欧元（IE州Lenehans），Flotec钻井泵225 GPH，售价17.14欧元（NL州Kooyman Megastore），以及更多产品，每台都有一个partle_url查看列表。
更多示例请参见 安装指南.
许可证
Apache-2.0--参见 许可证.