🚀 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 密钥