Clover MCP

🚀 Clover MCP（模型上下文協議）服務器

Clover MCP（模型上下文協議）服務器是一個使用OAuth身份驗證與Clover API交互的最小MCP服務器，它允許生成式AI模型和其他客戶端通過Model Context Protocol訪問您的Clover商家數據。

🚀 快速開始

使用Claude AI（推薦）

1. 將以下內容添加到您的Claude MCP設置中（通常位於~/.config/anthropic/claude.mcp.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. 使用Claude時：

/mcp use clover

3. 在與Claude的對話中啟動OAuth流程：

你能幫我連接到我的Clover賬戶嗎？

命令行使用

您可以直接運行MCP服務器：

# 一次安裝並運行
npx @ibraheem4/clover-mcp

# 帶有憑證
CLOVER_CLIENT_ID=your-client-id CLOVER_CLIENT_SECRET=your-client-secret npx @ibraheem4/clover-mcp

✨ 主要特性

此MCP服務器允許生成式AI模型和其他客戶端訪問您的Clover商家數據，通過Model Context Protocol。通過此集成，模型可以：

• 獲取商家信息
• 列出庫存商品
• 列出訂單
• 訪問單個商品和訂單

📦 安裝指南

Clover OAuth設置

使用此MCP服務器之前，需要設置Clover應用：

1. 在developer.clover.com創建Clover開發者賬戶
2. 在Clover開發者儀表盤中註冊新應用
3. 配置您的應用：
   • 站點URL：http://localhost:4000/oauth-callback
   • 默認OAuth響應：Code
4. 記下您的客戶端ID和客戶端密碼
5. 將這些憑證添加到環境變量或.env文件中

本地安裝

1. 克隆此倉庫
2. 安裝依賴項：

npm install

3. 設置OAuth憑證：

cp .env.example .env
# 使用您的Clover OAuth憑證編輯.env文件

4. 構建TypeScript代碼：

npm run build

5. 啟動服務器：

npm start

💻 使用示例

與Claude一起使用示例

以下是可用於Claude的一些示例提示：

基礎用法

# 連接到Clover
你能幫我連接到我的Clover賬戶嗎？

# 獲取商家信息
您有關於我的Clover商家賬戶的信息嗎？

# 列出庫存商品
顯示我庫存中的前10個項目。

# 列出訂單
您能列出我最近的訂單嗎？

🔧 技術細節

故障排除

• 確保您已正確設置環境變量CLOVER_CLIENT_ID和CLOVER_CLIENT_SECRET
• 驗證API請求是否成功，查看控制檯輸出

📄 許可證

此項目受MIT License保護。