kari catalog

kari 目录 MCP 服务

面向 kari 目录的公共 Model Context Protocol 服务。kari 是一家在俄罗斯、哈萨克斯坦和白俄罗斯经营鞋类、服装及配饰连锁店的零售商。AI 助手可使用它搜索商品、查询价格、查找门店，以及查看哪些门店有某个尺码的库存。

https://mcp.kari.com/mcp

• 传输方式：Streamable HTTP，无状态，JSON 响应。
• 无需身份验证或 API 密钥。
• 只读：服务不会下单，也没有购物车。购买和自提请通过商品 url 在网站上完成。
• 速率限制：每个 IP 地址每分钟 60 次请求。
• 注册表名称：官方 MCP 注册表中的 com.kari/catalog，见官方 MCP 注册表。

此代码库包含说明、客户端配置和一项 Agent 技能。服务本身运行于 kari，且不是开源的。

可以询问的内容

• “查找喀山 38 码、5000 卢布以下的白色运动鞋”
• “阿拉木图有没有门店可以在今天自提这款 41 码的商品？”
• “列出明斯克的 kari 门店及其营业时间”
• “比较这两款靴子的成分和评分”
• “Найди женские ботинки 37 размера в Москве со скидкой”

连接

Claude（claude.ai、桌面和移动应用）

设置 → 连接器 → 添加自定义连接器，URL 为 https://mcp.kari.com/mcp。 无需配置 OAuth。

Claude Code

claude mcp add --transport http kari https://mcp.kari.com/mcp

或者安装此代码库中的插件，同时添加服务和技能：

/plugin marketplace add kari-it/kari-mcp
/plugin install kari-catalog@kari

ChatGPT

设置 → 应用和连接器 → 高级 → 启用开发者模式，然后使用 URL https://mcp.kari.com/mcp 创建连接器，并将身份验证设为无身份验证。

VS Code / GitHub Copilot

.vscode/mcp.json：

{
  "servers": {
    "kari": { "type": "http", "url": "https://mcp.kari.com/mcp" }
  }
}

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "kari": { "url": "https://mcp.kari.com/mcp" }
  }
}

其他客户端

任何支持通过 Streamable HTTP 连接远程 MCP 服务的客户端。对于仅支持 stdio 的客户端，可使用 mcp-remote 等桥接工具：

{
  "mcpServers": {
    "kari": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.kari.com/mcp"] }
  }
}

工具

每个工具都需要传入 country：ru（俄罗斯，RUB）、kz（哈萨克斯坦，KZT）或 by（白俄罗斯，BYN）。价格和库存取决于城市；未提供 city_id 时将使用首都。

工具	功能	主要输入
find_city	按城市名称中的部分内容查找 kari 营业城市；最多返回 10 个城市及其 city_id	query
find_stores	查找城市中的门店，返回地址、营业时间和坐标；可按名称、地址、购物中心或地铁筛选；每页 10 家	city_id、query、page
search_products	按筛选条件搜索目录；返回价格、尺码范围和网站链接	query、city_id、price_min、price_max、size、brand、sort、limit、page
get_product	商品详情：价格、图片、颜色、成分、评分，以及该城市的尺码库存情况	articul、city_id
check_availability	查询该城市哪些门店可以交付相应尺码，以及何时可以自提；不公开数量	articul、size、city_id

sort：relevance、price_asc、price_desc、rating、discount。

所有工具均标注为 readOnlyHint: true、destructiveHint: false。

典型流程

1. 使用用户所在的城市调用 find_city，并保留 city_id。
2. 使用用户所用语言的请求和筛选条件调用 search_products。
3. 对选定的 articul 调用 get_product，获取尺码、成分和 available。
4. 针对该尺码调用 check_availability，查询哪些门店可以交付以及何时可以交付。
5. 将商品的 url 提供给用户；下单在网站上完成。

模型须知：

• search_products 中的 sizes 是该款式的尺码范围，并非库存。
• get_product 中的 available 表示该商品可以在此城市订购（从门店或仓库订购），并不表示今天就在货架上。自提时间请通过 check_availability 查询。
• 没有尺码的商品（包袋、配饰）的 sizes 为空；调用 check_availability 时不要传入 size。
• 只有网站显示降价时，才会提供 old_price 和 discount_percent。

不使用 MCP 客户端调用

每个 POST 请求发送一条 JSON-RPC 2.0 消息；不支持批量请求，也不需要会话标头。

curl -X POST https://mcp.kari.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"country":"ru","query":"белые кроссовки","limit":3}}}'

供模型使用的纯文本说明位于 https://mcp.kari.com/。

Agent 技能

skills/kari-catalog/SKILL.md 是一项 Agent 技能，用于告知 Agent 何时使用此服务以及按什么顺序调用工具。Claude Code 会通过上面的插件加载它；其他 Agent 可以将该文件夹复制到自己的技能目录中。

发现

• https://kari.com/llms.txt、https://kari.com/ai/ — 面向用户和模型的说明。
• https://mcp.kari.com/.well-known/mcp/server-card.json 和 https://kari.com/.well-known/mcp.json — 服务卡片。
• server.json — 在 MCP Registry 中发布的条目。

На русском

kari 目录的开源 MCP 服务：在俄罗斯、哈萨克斯坦和白俄罗斯搜索鞋类、服装和配饰，查询价格、门店及尺码库存。地址为 https://mcp.kari.com/mcp，无需授权，仅支持读取，每个地址每分钟最多 60 次请求。连接说明请参阅 https://kari.com/ai/。

联系方式

有关服务的问题：https://kari.com/ai/。