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

- 查看目前验证到什么程度的标准文档

1. docs/REMAINING_BLOCKERS.md

- 整理当前被阻止的项目和原因

1. docs/WRITE_RUNBOOK.md

- 实际写入验证顺序和注意事项

1. docs/IMPLEMENTATION_NOTES.md

- 请求身体形状、活动行为、警告기록

1. 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个问题集