mcp/iaptic

Iaptic MCP服务器

与iaptic交互的模型上下文协议（MCP）服务器。

什么是MCP服务器？

MCP信息

镜像构建信息

可用工具（16种）

---

工具详情

工具：customer_add_purchase

手动将客户与购买关联。

• 将购买关联到特定客户
• 优先级高于收据验证链接
• 适用于手动购买管理
• 购买格式应为"平台:purchaseId"，例如apple:123109519983
• 必需：customerId和purchaseId | 参数 | 类型 | 描述 | |------|------|------| | customerId | string | 客户的应用用户名 | | purchaseId | string | 要关联的购买ID |

---

工具：customer_get

获取特定客户的详细信息。

• 返回完整的客户资料，包括：
  • 应用用户名
  • 购买历史
  • 活跃和已过期的订阅
  • 最近购买详情
  • 订阅续订状态
  • 试用和介绍期信息
• 必需：customerId参数 | 参数 | 类型 | 描述 | |------|------|------| | customerId | string | 客户的唯一标识符 |

---

工具：customer_list

列出iaptic账户中的客户。

• 返回带购买状态的分页客户列表
• 每个客户包含：
  • 应用用户名
  • 最近购买信息
  • 订阅状态（活跃/失效）
  • 续订意向
  • 试用/介绍期状态
• 使用limit和offset进行分页（默认：每页100个客户）
• 结果按创建日期排序（最新优先） | 参数 | 类型 | 描述 | |------|------|------| | limit | number 可选 | 返回的最大客户数（默认：100） | | offset | number 可选 | 分页跳过的客户数 |

---

工具：customer_subscription

获取客户的订阅状态。

• 返回活跃的订阅详情（如有）
• 包括：
  • 订阅状态和到期时间
  • 支付和续订信息
  • 试用/介绍期状态
• 对于仅订阅应用，是customer_get的简化替代方案 | 参数 | 类型 | 描述 | |------|------|------| | customerId | string | 客户的应用用户名 |

---

工具：customer_transactions

获取客户的交易历史。

• 返回所有交易列表
• 包括：
  • 支付详情
  • 交易状态
  • 关联的购买
  • 时间戳 | 参数 | 类型 | 描述 | |------|------|------| | customerId | string | 客户的应用用户名 |

---

工具：event_list

列出iaptic账户中的近期事件。

• 返回系统事件的分页列表
• 事件包括：
  • 收据验证
  • 平台通知（Apple/Google等）
  • Webhook交付
  • 购买状态变更
  • 订阅续订
• 使用limit和offset进行分页
• 结果按日期排序（最新优先） | 参数 | 类型 | 描述 | |------|------|------| | enddate | string 可选 | 筛选此日期之前的事件（ISO格式，如2024-12-31） | | limit | number 可选 | 返回的最大事件数（默认：100） | | offset | number 可选 | 分页跳过的事件数 | | startdate | string 可选 | 筛选此日期之后的事件（ISO格式，如2024-01-01） |

---

工具：iaptic_current_app

获取当前活动的iaptic应用信息。

• 返回当前应用名称
• 指示是否使用默认或自定义凭据

工具：iaptic_reset_app

重置为默认的iaptic应用。

• 恢复到服务器初始化期间提供的原始应用凭据
• 所有后续API调用将使用默认应用名称和API密钥
• 在使用iaptic_switch_app后使用此命令返回默认应用

工具：iaptic_switch_app

切换到其他iaptic应用。

• 允许临时使用其他应用的凭据
• 所有后续API调用将使用新的应用名称和API密钥
• 适用于在同一会话中管理多个应用
• 必需：appName参数（apiKey仅在不使用主密钥时需要） | 参数 | 类型 | 描述 | |------|------|------| | appName | string | 要切换到的应用名称 | | apiKey | string 可选 | 应用的API密钥（使用主密钥时不需要） |

---

工具：purchase_get

获取特定购买的详细信息。

• 返回完整的购买详情，包括：
  • 产品信息
  • 购买状态
  • 关联交易
  • 客户信息
  • 订阅详情（如适用）
• 必需：purchaseId参数 | 参数 | 类型 | 描述 | |------|------|------| | purchaseId | string | 购买的唯一标识符 |

---

工具：purchase_list

列出iaptic账户中的购买记录。

• 返回分页的购买列表
• 使用limit和offset进行分页（默认：每页100条）
• 使用startdate和enddate按日期范围筛选（ISO格式）
• 使用customerId筛选特定客户的购买记录
• 结果包括购买状态、产品信息和交易详情
• 结果按购买日期排序（最新优先） | 参数 | 类型 | 描述 | |------|------|------| | customerId | string 可选 | 按客户ID筛选购买记录 | | enddate | string 可选 | 筛选此日期之前的购买（ISO格式，如2024-12-31） | | limit | number 可选 | 返回的最大购买数（默认：100，最大：1000） | | offset | number 可选 | 分页跳过的购买数 | | startdate | string 可选 | 筛选此日期之后的购买（ISO格式，如2024-01-01） |

---

工具：stats_app

获取应用特定的统计数据。

• 返回应用特定指标，包括：
  • 应用收入和增长
  • 此应用的活跃订阅
  • 此应用的客户指标
  • 产品性能统计
  • 交易指标
• 使用服务器初始化期间提供的应用名称

工具：stats_get

获取iaptic账户的总体交易、收入和使用统计数据。

• 返回聚合指标，包括：
  • 总收入
  • 活跃订阅数量
  • 客户增长指标
  • 交易成功率
  • 按产品类型的收入
• 数据聚合自所有应用

工具：stripe_prices

获取可用的Stripe产品和价格。

• 返回产品及其关联价格的列表
• 每个产品包括：
  • 产品ID和显示名称
  • 描述和元数据
  • 可用定价方案
  • 订阅条款（如适用）
• 结果缓存5分钟

工具：transaction_get

获取特定交易的详细信息。

• 返回完整的交易详情，包括：
  • 交易状态
  • 金额和货币
  • 支付方式详情
  • 关联的购买信息
  • 客户信息
  • 时间戳和审计数据
• 必需：transactionId参数 | 参数 | 类型 | 描述 | |------|------|------| | transactionId | string | 交易的唯一标识符 |

---

工具：transaction_list

列出iaptic账户中的财务交易。

• 返回分页的交易列表
• 使用limit和offset进行分页（默认：每页100条）
• 使用startdate和enddate按日期范围筛选（ISO格式）
• 使用purchaseId筛选特定购买的交易
• 结果包括交易状态、金额、货币和支付详情
• 结果按交易日期排序（最新优先）
• 重要：使用日期筛选以避免检索过多记录 | 参数 | 类型 | 描述 | |------|------|------| | enddate | string 可选 | 筛选此日期之前的交易（ISO格式，如2024-12-31） | | limit | number 可选 | 返回的最大交易数（默认：100，最大：1000） | | offset | number 可选 | 分页跳过的交易数 | | purchaseId | string 可选 | 按购买ID筛选交易 | | startdate | string 可选 | 筛选此日期之后的交易（ISO格式，如2024-01-01） |

---

使用此MCP服务器

json
{
  "mcpServers": {
    "iaptic": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "IAPTIC_APP_NAME",
        "-e",
        "IAPTIC_API_KEY",
        "mcp/iaptic"
      ],
      "env": {
        "IAPTIC_APP_NAME": "your-app-name-here",
        "IAPTIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

为什么使用Docker运行MCP服务器更安全？