AI导哈

智能商店MCP工具

一个将Naver Commerce API封装为MCP工具的服务，用于处理商品、订单、客户服务和结算任务。

  • by Hayeon27
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Hayeon27/smartstore-mcp

使用说明

智能商店mcp

FastMCP服务器，使智能商店卖家任务可以用作MCP工具。

该存储库将NAVER Commerce API封装为MCP工具，允许在Claude或GPT等MCP客户端上处理商品、订单、CS和结算任务。不是简单的示例，而是使用实际卖家帐户进行了读/写验证，其中包括验证历史记录和操作脚本。

这个项目能做什么

  • 使用SmartStore官方API作为MCP工具
  • 使用商品/订单/CS/结算相关阅读工具
  • 验证部分商品/订单写入操作
  • 使用模板工具创建安全的payload草案
  • 通过脚本直接查看验证状态、blocker和以下动作

当前状态

  • 工具总数： 127
  • 完成读取验证： 75
  • 完成实写验证： 28
  • 部分验证： 24
  • 请求shape未解决： 0
  • 未验证： 0

也就是说，基于普通卖家帐户，实施几乎已经完成，剩下的大部分项目都需要外部条件或特定订单状态。

首先阅读的是好的文档

按以下顺序可以最快地确定结构。

  1. docs/VERIFICATION_MATRIX.md
    • 查看目前验证到什么程度的标准文档
  2. docs/REMAINING_BLOCKERS.md
    • 整理当前被阻止的项目和原因
  3. docs/WRITE_RUNBOOK.md
    • 实际写入验证顺序和注意事项
  4. docs/IMPLEMENTATION_NOTES.md
    • 请求身体形状、活动行为、警告기록
  5. docs/HANDOFF_NEXT_THREAD.md
    • 转到下一主题或其他帐户时查看的文档

准备本地运行

1.获取存储库

git clone "https://github.com/Hayeon27/smartstore-mcp.git"
cd smartstore-mcp

2.安装依赖性

建议：

uv sync --extra dev

替代方案：

pip install -e .[dev]

3.设置环境变量

.env.example请参见，输入以下值。

  • SMARTSTORE_CLIENT_ID
  • SMARTSTORE_CLIENT_SECRET

示例：

SMARTSTORE_CLIENT_ID=your_client_id
SMARTSTORE_CLIENT_SECRET=your_client_secret

4.运行服务器

python -m smartstore_mcp

MCP客户端连接示例

{
  "mcpServers": {
    "smartstore": {
      "command": "python",
      "args": ["-m", "smartstore_mcp"],
      "env": {
        "SMARTSTORE_CLIENT_ID": "your_client_id",
        "SMARTSTORE_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

第一次运行的话，马上就会尝试。

1.阅读烟熏测试

uv run python scripts/smoke_readonly.py

快速检查当前帐户的默认读取API是否正常。

2.检查状态报告

uv run python scripts/verification_matrix.py
uv run python scripts/remaining_blockers_report.py
uv run python scripts/next_actions_report.py
uv run python scripts/write_validation_dashboard.py

每个脚本的用途：

  • verification_matrix.py
    • 完整验证状态摘要
  • remaining_blockers_report.py
    • 只提取剩余的blocker
  • next_actions_report.py
    • 把现在能做的和堵塞的分开
  • write_validation_dashboard.py
    • 按步骤显示写入准备情况

3.确认报告完整性

uv run python scripts/report_smoke.py

检查报告之间的数字和状态是否相符。

在当前帐户中立即可用

相对安全的write:

  1. smartstore_change_product_status
  2. smartstore_create_delivery_bundle_group

需要注意的是：

  • smartstore_update_stock
    • 虽然有动作。 useStockManagement=true可以留下
  • smartstore_update_inquiry_answer
    • 在当前帐户中， ERR-NC-101006
  • orderOperations
    • 实际订单状态发生了变化，因此运营影响很大

Q&A和Inquiry不同

在这个项目中，CS系列分为两个家庭。

问答

  • 商品咨询系列
  • 路径： /v1/contents/qnas*
  • 相关工具：
    • smartstore_get_qnas
    • smartstore_get_qna_templates
    • smartstore_answer_qna

Naver薪酬查询

  • NAVER Pay咨询系列
  • 路径： /v1/pay-merchant/inquiries*
  • 相关工具：
    • smartstore_get_inquiries
    • smartstore_answer_inquiry
    • smartstore_update_inquiry_answer

参考文档

  • docs/API_SCOPE_AUDIT.md文件
  • docs/MISSING_API_ROADMAP.mod文件
  • docs/VERIFICATION_MATRIX.md
  • docs/REMAINING_BLOCKERS.md
  • docs/WRITE_RUNBOOK.md
  • docs/IMPLEMENTATION_NOTES.md
  • docs/HANDOFF_NEXT_THREAD.md
  • docs/smartstore_readonly_evaluation.xml
    • MCP builder/evaluation的只读10个问题集

相关 MCP