Clover MCP (Model Context Protocol) Server

基本能力

产品定位

Clover MCP Server 是一个用于与Clover API交互的MCP服务器，主要用于金融服务领域，特别是商户数据管理。

核心功能

• 检索商户信息
• 列出库存物品
• 列出订单
• 访问单个物品和订单

适用场景

• 商户数据管理
• 库存管理
• 订单管理

工具列表

• get_oauth_status: 检查OAuth凭据是否可用
• initiate_oauth_flow: 启动OAuth流程以获取访问令牌
• get_merchant_info: 获取商户信息
• list_inventory: 列出库存物品（可选过滤器）
• list_orders: 列出订单（可选过滤器）

常见问题解答

1. OAuth问题：
2. 验证Clover应用是否已正确注册
3. 检查应用设置中的站点URL是否为http://localhost:4000/oauth-callback
4. 确保Client ID和Client Secret正确
5. 确保开发者仪表板中的“Default OAuth Response”设置为“Code”
6. 尝试使用initiate_oauth_flow重新启动OAuth流程

使用教程

使用依赖

1. 创建Clover开发者账户：developer.clover.com
2. 在Clover开发者仪表板中注册新应用
3. 配置应用：
4. 站点URL: http://localhost:4000/oauth-callback
5. Default OAuth Response: Code
6. 记录Client ID和Client Secret
7. 将这些凭据添加到环境变量或.env文件

安装教程

1. 使用Claude AI（推荐）: json { "mcpServers": { "clover": { "command": "npx", "args": ["-y", "@ibraheem4/clover-mcp"], "env": { "CLOVER_CLIENT_ID": "your-clover-client-id", "CLOVER_CLIENT_SECRET": "your-clover-client-secret", "CLOVER_BASE_URL": "https://apisandbox.dev.clover.com" }, "disabled": false, "autoApprove": ["initiate_oauth_flow", "get_merchant_info", "list_inventory", "list_orders"] } } }
2. 使用命令行: bash npx @ibraheem4/clover-mcp 或 bash CLOVER_CLIENT_ID=your-client-id CLOVER_CLIENT_SECRET=your-client-secret npx @ibraheem4/clover-mcp

调试方式

1. 本地安装: bash npm install cp .env.example .env npm run build ./run.sh
2. 发布更新: bash npm version patch npm run build npm publish

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。