Iaptic MCP 服务器

一个用于与 Iaptic API 交互的模型上下文协议 (MCP) 服务器。该服务器允许 Claude 或其他 AI 与您的 Iaptic 数据进行交互，以回答有关您的客户、购买、交易和统计信息的问题。

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Iaptic：

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

手动安装

# Run directly with npx
npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

# Or install globally
npm install -g mcp-server-iaptic
mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

Related MCP server: MCP Unified Server

在 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 获取详细的客户信息

• customer_subscription: 获取客户的有效订阅状态

• customer_transactions: 获取客户的交易历史记录

• customer_add_purchase: 手动将购买关联到客户

购买

• 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）

  • raw: 返回原始 JSON 而不是格式化输出（默认：false）

• event_details: 获取特定事件的详细信息（验证器 3.12+）

  • eventId: 要获取详情的事件 ID

  • receipts: 包含收据验证详情（默认：false）

Stripe

• stripe_prices: 获取可用的 Stripe 产品和价格

应用管理

• iaptic_switch_app: 切换到不同的 Iaptic 应用

  • appName: 要切换到的应用名称

  • apiKey: 该应用的 API 密钥

• iaptic_reset_app: 重置为默认的 Iaptic 应用

• iaptic_current_app: 获取当前活动应用的信息

开发

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run production build
npm start

要求

• Node.js >= 18

• 拥有 API 凭据的 Iaptic 账户

许可证

MIT