MCP Server Iaptic

🚀 Iaptic 模型上下文協議 (MCP) 服務器

一個用於與 Iaptic API 交互的模型上下文協議服務器。此服務器允許 Claude 或其他 AI 與您的 Iaptic 數據互動，以回答有關客戶、購買、交易和統計信息的問題。

🚀 快速開始

此服務器可讓 Claude 等 AI 與 Iaptic 數據交互，為您解答客戶、購買、交易和統計信息等相關問題。您可以按照以下步驟進行安裝和使用。

📦 安裝指南

使用 Smithery 安裝

通過 Smithery 自動安裝 Iaptic：

npx -y @smithery/cli install mcp-server-iaptic --client claude

手動安裝

# 直接運行
npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

# 或全局安裝
npm install -g mcp-server-iaptic
mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

💻 使用示例

與 Claude Desktop 配合使用

將以下內容添加到您的 Claude Desktop 配置文件中：

{
  "iaptic": {
    "command": "npx",
    "args": [
      "mcp-server-iaptic",
      "--api-key", "your-api-key-here",
      "--app-name", "your-app-name-here"
    ]
  }
}

📚 詳細文檔

可用工具

客戶

• customer_list: 列出客戶
• customer_get: 根據 ID 獲取客戶詳細信息

購買

• purchase_list: 列出購買記錄
  • limit: 返回的最多購買數（默認：100，最大：1000）
  • offset: 分頁跳過的數量
  • startdate: 過濾購買日期後的記錄（ISO 格式，例如 2024-01-01）
  • enddate: 過濾購買日期前的記錄（ISO 格式，例如 2024-12-31）
  • customerId: 按客戶 ID 過濾
• purchase_get: 根據 ID 獲取購買詳細信息

交易

• transaction_list: 列出帶分頁和日期過濾的交易記錄
  • limit: 返回的最大交易數（默認：100，最大：1000）
  • offset: 分頁跳過的數量
  • startdate: 過濾交易日期後的記錄（ISO 格式，例如 2024-01-01）
  • enddate: 過濾交易日期前的記錄（ISO 格式，例如 2024-12-31）
  • purchaseId: 按購買 ID 過濾
• transaction_get: 根據 ID 獲取交易詳細信息

統計

• stats_get: 獲取交易和收入的一般統計信息
• stats_app: 獲取應用程序特定的統計信息

事件

• event_list: 列出帶分頁和日期過濾的近期事件
  • limit: 返回的最大事件數（默認：100）
  • offset: 分頁跳過的數量
  • startdate: 過濾事件日期後的記錄（ISO 格式，例如 2024-01-01）
  • enddate: 過濾事件日期前的記錄（ISO 格式，例如 2024-12-31）

應用管理

• iaptic_switch_app: 切換到不同的 Iaptic 應用程序
  • appName: 要切換的應用程序名稱
  • api-key: 新應用程序的 API 密鑰
• iaptic_get_apps: 獲取所有可用的 Iaptic 應用程序

🔧 技術細節

開發

npm install

npm run dev

要求

• Node.js: 最低版本 16.0.0
• 您需要一個有效的 Iaptic 賬戶和 API 密鑰