库存数据连接服务

连接AI代理到实时库存数据的服务,支持与Claude Desktop、OpenClaw等MCP兼容客户端交互。

  • by ReplenishRadar
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ReplenishRadar/MCP

使用说明

@补充雷达/mcp服务器

将AI代理连接到实时 补给雷达 库存数据。适用于Claude Desktop、OpenClaw和任何兼容MCP的客户端。

设置

  1. 从获取API密钥 补货雷达>设置>API键.
  2. 将此服务器添加到MCP客户端配置中。在Claude Desktop中,打开 设置>开发人员>编辑配置:
{
  "mcpServers": {
    "replenishradar": {
      "command": "npx",
      "args": ["-y", "@replenishradar/mcp-server"],
      "env": {
        "REPLENISHRADAR_API_KEY": "rr_sk_your_key_here"
      }
    }
  }
}
  1. 重新启动Claude Desktop并询问:“我的最大缺货风险是什么?”

还没有补货雷达帐户?在配置服务器之前,使用公共代理入口端点请求一个短期只读沙盒密钥:

POST https://api.replenishradar.com/api/public/agent-intake

可用工具

阅读

标准包括有限的读取API访问权限。增长增加了诊断/状态读取工具。

工具 说明
rr_get_stockout_risk SKU的缺货风险水平
rr_get_inventory_position 按地点分类的商品库存
rr_get_demand_forecast 需求预测统计数据
rr_get_suggested_purchase_orders 建议PO
rr_get_replenishment_actions 典型的买家补货行动
rr_get_replenishment_action 一次带有事件历史记录的补货操作
rr_get_alerts 活动警报
rr_list_items 列出库存项目
rr_get_sync_status 最近的同步历史记录
rr_list_suppliers 列出供应商/供货商
rr_list_purchase_orders 列出采购订单
rr_get_purchase_order 包含行项目的单个采购订单
rr_get_po_pdf PO PDF信息
rr_get_po_documents 采购订单所附文件
rr_get_po_notes 采购订单所附注释
rr_get_sales_history 销售历史
rr_get_top_sellers 畅销SKU
rr_get_slow_movers 移动缓慢的SKU
rr_get_inventory_value 存货价值明细
rr_get_sku_health SKU级别运行状况摘要
rr_get_lost_sales 估计缺货造成的销售损失
rr_get_store_health 存储连接和同步运行状况
rr_get_data_freshness 按数据维度划分的新鲜度状态
rr_get_setup_status 设置里程碑和下一步
rr_get_recent_activity 最近的警报、PO和同步汇总
search_knowledge 补充雷达产品知识搜索
rr_evaluate_fit 确定性ICP+层级匹配判断(无组织数据)

基础写作(标准层及以上)

安全,低爆炸半径写-没有钱或股票突变。

工具 说明
rr_acknowledge_alert 确认警报
rr_add_po_note 在采购订单中添加备注
rr_request_approval 请求人工批准采购订单
rr_add_replenishment_action_note 在补货操作中添加注释
rr_dismiss_replenishment_action 取消补货操作
rr_prepare_replenishment_action 预览操作并获取其当前状态 updated_at 执行前
rr_execute_replenishment_action 执行一个动作。 mode="draft" (默认)创建采购订单和/或转让草案; mode="autonomous" 当密钥具有敏感写入+操作工具组+启用的预算并且所有防护措施都通过时(否则起草回退或硬拒绝),也会发送PO/提交传输。过时、陈旧的国家保护
rr_resolve_replenishment_action 将一个行动视为没有理由的行动;幂等、过时状态保护
rr_retry_replenishment_action 通过草稿执行路径重试被阻止或失败的操作;幂等、过时状态保护
rr_get_document_upload_url 获取采购订单文档的上传URL
rr_record_pi_review 记录形式发票详细信息

敏感写入(增长层及以上)

货币/股票突变。

工具 说明
rr_trigger_sync 触发库存同步
rr_create_purchase_order 创建采购订单草稿
rr_update_purchase_order 更新采购订单草案
rr_send_purchase_order 发送已批准的采购订单
rr_cancel_purchase_order 取消订单
rr_create_location 创建手动库存位置
rr_set_stock_at_location 在手动位置设置库存

PO创建总是从 草案. rr_send_purchase_order 只发送已经经过人工批准的PO。

动作执行有两种模式。 rr_execute_replenishment_action 与 mode="draft" (默认)为行动的项目创建采购订单草案和/或转账草案,从不自动发送给供应商或承诺库存。随着 mode="autonomous" 它还发送PO或提交传输,但仅当密钥具有 sensitive_write +运营工具组+按关键预算启用(autonomous_enabled=true)每道护栏都通过;否则,它将留下草稿并返回 rr_request_approval 提示(draft_fallback)或拒绝而不变异(hard_refuse).呼叫 rr_prepare_replenishment_action 首先获取动作的当前状态 updated_at,然后将其作为 expected_updated_at 因此,在任何写入之前,过时的操作都会被拒绝。通过马厩 idempotency_key 因此,重试的调用会重放原始结果,而不是重复创建工件或重复发送。

代理上下文存储

一个小型的、组织范围的、可审计的键/值内存,因此代理可以记住有界的工作流状态。 rr_get_agent_context / rr_list_agent_context 具有读取能力; rr_set_agent_context / rr_delete_agent_context 是基本的写作。这四个人都在 agent_context 工具组。

工具 说明
rr_get_agent_context 通过以下方式获取一个条目 namespace + key;过期的条目将被省略
rr_set_agent_context 将有界JSON对象存储在 namespace + key (可选 scope_ref, ttl_seconds)
rr_list_agent_context 列出ONE的实时条目 namespace (必填),有界 limit (最多200)
rr_delete_agent_context 删除一个条目 namespace + key记录演员的来源

规则和限制:

  • 命名空间由代码拥有,并按每个键分配。 管理员必须在“设置”>“API密钥”中的每个命名空间上授予API密钥读/写/删除权限。仅同一组织访问权限 不 足够了。
  • 没有秘密,没有原始个人身份信息。 看起来像令牌、密码、私钥、凭据或原始电子邮件/电话/地址的写入将被拒绝。
  • value 必须是 JSON对象 (不是标量或数组),上限为 16千磅 序列化。
  • ttl_seconds 是可选的,上限为 90天;如果没有TTL,则该条目在组织存在时仍然存在。
  • rr_list_agent_context 需要 namespace 并且从不跨命名空间列出。
  • scope_ref 仅是描述性元数据 不 唯一性的一部分-将每个作用域条目编码到 key (例如 supplier_rules/sku:ABC123).
  • 敏感命名空间(例如 sourcing_economics)另外需要掌握敏感经济阅读能力+工具组的钥匙。

支出预算(由管理员管理,无MCP工具)

Per-API-主要支出预算-Per-PO价值上限,滚动24小时每日上限,最大转移数量增量 autonomous_enabled 标记和供应商/目的地/传输源(或路由对)的分配列表-约束自治密钥可以购买或移动的内容。他们被管理 仅 在“设置”>“API密钥”(JWT-admin设置API)中由管理员管理;没有MCP工具可以读取或更改预算,并且API密钥无法到达预算路线,即使对于其自身的上限也是如此。预算仅由自主发送/提交消耗,默认情况下自主模式处于关闭状态,被拒绝的自主操作只会收到一个简短的决策原因,而不会收到上限金额、分配列表或其他密钥的分类账。

速率限制

  • 标准 (99美元/月):10次通话/小时,读+基本写工具
  • 成长 (199美元/月):100个电话/小时,读+基本+敏感读/写+诊断/状态工具
  • 规模 (499美元/月):1000次呼叫/小时,完整的读写功能集

了解更多