MCP Server Iaptic

🚀 Iaptic 模型上下文协议 (MCP) 服务器

Iaptic 模型上下文协议 (MCP) 服务器用于与 Iaptic API 进行交互。借助该服务器，Claude 或其他 AI 能够与您的 Iaptic 数据互动，从而回答有关客户、购买、交易和统计信息等方面的问题。

🚀 快速开始

Iaptic 模型上下文协议 (MCP) 服务器可帮助您实现 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 密钥。