三星Checkout MCP服务器
用于开发Samsung Smart TV应用程序内支付（Samsung Checkout/DPI）的模型上下文协议（MCP）服务器。
连接AI编码工具（Claude、Cursor等）可以实时支持Samsung Checkout开发所需的API参考、代码生成和故障诊断。
______________________________________________________________________
安装和连接
方法1:npx（npm部署后）
无需单独安装即可使用：
{
"mcpServers": {
"samsung-checkout": {
"command": "npx",
"args": ["-y", "samsung-checkout-mcp"]
}
}
}方法2：直接本地运行
git clone https://github.com/HoRockx2/samsung-checkout-mcp.git
cd samsung-checkout-mcp
npm install克劳德桌面版
~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"samsung-checkout": {
"command": "node",
"args": ["/절대경로/samsung-checkout-mcp/src/index.js"]
}
}
}克劳德代码（CLI）
claude mcp add samsung-checkout node "/절대경로/samsung-checkout-mcp/src/index.js"光标
Settings > MCP在中添加，或在项目根目录中 .cursor/mcp.json 创建：
{
"mcpServers": {
"samsung-checkout": {
"command": "node",
"args": ["/절대경로/samsung-checkout-mcp/src/index.js"]
}
}
}连接成功时，Settings>MCP显示绿色圆点。
______________________________________________________________________
提供工具（Tools）
| 工具名 | 说明 |
|---|---|
lookup_api | 查询Billing API、DPI API参考（参数，代码示例） |
generate_checkvalue_guide | CheckValue（HMAC SHA256）生成指南（API特定公式，多语言代码） |
get_implementation_guide | 按产品类型（Consumable/Subscription等）完整实施流程 |
troubleshoot | 错误代码/基于症状的诊断和解决方案指南 |
get_setup_checklist | 首选参数逐步核对表（Seller Office→DPI→测试→发布） |
get_code_snippet | 客户端/服务器锅炉板和代码段 |
search_knowledge | 搜索全部知识库关键字 |
______________________________________________________________________
用户场景
Scenario1：首次开始Samsung Checkout开发
我要在Samsung TV APP中加入APP支付，从哪里开始？
AI get_setup_checklist 调用该工具，提供从注册Seller Office到设置DPI门户、注册商品、配置.xml的分步指南。
其他问题示例：
- “如何注册Seller Office？”
- “应该在config.xml中添加什么特权？”
- “如何注册Test Buyer？”
______________________________________________________________________
Scenario2：当您想知道如何使用特定API时
“告诉我buyItem API参数”
AI lookup_api 调用该工具以提供buyItem（）的完整参数规格、必需/可选性、类型、说明和代码示例。
其他问题示例：
- “如何调用getUserPurchaseList？”
- “展示DPI服务器API中的购买验证API规格”
- “cont/apply API的请求/响应格式是什么？”
- “让我看看服务器API的完整列表”
______________________________________________________________________
Scenario3：当您想知道如何实现不同类型的商品时
“Consumable产品的实现流程是什么？”
AI get_implementation_guide 调用该工具，引导您完成从购买Consumable商品到服务器验证到Apply处理的整个流程。
其他问题示例：
- “如何实现订阅（Subscription）产品？”
- “Non-Consumable和Limited Period有什么区别？”
- “请告知退订流程”
- “请比较各商品类型的差异”
______________________________________________________________________
Scenario4:CheckValue需要创建时
“如何将cont/verify API的CheckValue创建为Python？”
AI generate_checkvalue_guide 调用该工具以提供API的参数连接顺序、HMAC SHA256散列方法和Python代码示例。
其他问题示例：
- “CheckValue是什么？为什么需要？”
- “请告知invoice/list API的CheckValue公式”
- “让我看看用Java生成CheckValue的代码”
- “CheckValue经常犯什么错误？”
______________________________________________________________________
Scenario5：发生错误时
“0410424错误是什么？”
AI troubleshoot 调用该工具以指示错误代码的原因和解决方法。
其他问题示例：
- “CheckValue Invalid出错了怎么办？”
- “在Staging可以，但在Production不行”
- “我呼叫了buyItem，结果显示‘Billing not available’”
- “虽然购买了，但不能申请”
- “Samsung Account登录失败”
______________________________________________________________________
Scenario 6:需要代码锅炉板时
“给我服务器的所有代码锅炉板”
AI get_code_snippet 调用工具以提供基于Node.js的DPI服务器的完整代码。
其他问题示例：
- “给我看客户端的完整代码示例”
- “给我config.xml模板”
- “只显示调用buyItem的代码”
- “给我购买验证（verify）代码段”
______________________________________________________________________
Scenario7：当您想使用特定关键字查找信息时
“OrderCustomID是什么？”
AI search_knowledge 调用该工具查找并返回整个文档中包含该关键字的部分。
其他问题示例：
- “请帮我查找Free Trial的相关内容”
- “CountryCode写在哪里？”
- “在哪里办理SecurityKey？”
- “告诉我关于invoice的整体情况”
______________________________________________________________________
Scenario8：实际开发中的复杂问题
在实际开发过程中，会组合使用多个工具：
“我要做Subscription产品。请一次性告诉我实现流程、服务器API规格、CheckValue生成方法，还有服务器锅炉板。”
AI get_implementation_guide, lookup_api, generate_checkvalue_guide, get_code_snippet依次调用以提供综合指南。
复合问题示例：
- “现在正在开发Consumable产品，在调用buyItem后，请将服务器验证的整个过程连同代码一起告知我。”
- “请告知生产部署前需要确认的核对表和Staging/PRD环境的区别”
- “结算联动测试时出错了，错误代码是0410424，好像是CheckValue相关的。”
______________________________________________________________________
测试
npm test71个测试包括10个类别：
- MD文件是否存在（9个文档）
- Markdown解析器默认行为
- 验证文档加载
- 知识库内容质量（是否缺少必需数据）
- 搜索功能
- 搜索节
- 提取代码块
- 呈现内容
- 边缘外壳&坚固性
- 数据一致性（跨文档交叉验证）
修改docs/的MD文件后 npm test请用验证质量。
______________________________________________________________________
数据维护
知识库 docs/ 作为目录中的Markdown文件进行管理。无需修改代码，只需编辑MD文件即可。
docs/
├── 01-overview.md # 전체 개요, 아키텍처, 상품 타입
├── 02-client-billing-api.md # buyItem, getUserPurchaseList 상세 스펙
├── 03-dpi-server-api.md # DPI 서버 API 5종
├── 04-security-checkvalue.md# CheckValue 생성 가이드 (4개 언어)
├── 05-setup-and-testing.md # 환경 설정 8단계, 테스트, 출시 체크리스트
├── 06-troubleshooting.md # 에러코드, FAQ, 디버깅 팁
├── 07-implementation-flows.md# 상품 타입별 구현 플로우
├── 08-code-snippets.md # 클라이언트/서버 보일러플레이트
└── 09-references.md # 공식 문서, 포털, GitHub 링크许可证
麻省理工学院