MCP Server for Iaptic

Iaptic 的 MCP 服务

用于与 Iaptic API 交互的模型上下文协议服务。此服务允许 Claude 或其他 AI 与你的 Iaptic 数据交互，以回答有关客户、购买、交易和统计数据的问题。

范围

此服务对你的 Iaptic 数据仅提供只读访问：工具可以查询客户、购买、交易、事件和统计数据，但无法修改记录、退款或更改 Iaptic 配置。三组工具在已存储数据之外运行：stripe_checkout / stripe_portal 是唯一会创建内容的工具——创建 Stripe 结账或账单门户会话（客户可通过链接付款或管理订阅），但不会创建 Iaptic 记录；stripe_purchases 通过结账会话访问令牌查询客户的购买记录；iaptic_switch_app / iaptic_reset_app 则会更改后续查询所使用的应用凭据。

安装

通过 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

在 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：获取客户的交易历史记录

购买

• 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：获取特定事件的详细信息（validator 3.12+）
  • eventId：要获取详情的事件 ID
  • receipts：包含收据验证详情（默认值：false）

Stripe

• stripe_prices：获取可用的 Stripe 产品和价格
• stripe_checkout：创建 Stripe Checkout 会话并返回付款链接
  • offerId：要购买的优惠 ID，由 stripe_prices 返回
  • successUrl：付款成功后重定向客户的 URL
  • cancelUrl：客户取消时重定向客户的 URL
  • applicationUsername：应用中的用户标识符（可选）
  • mode：payment 或 subscription（可选；默认值取决于价格类型）
  • accessToken：之前购买时获取的访问令牌，用于复用现有的 Stripe 客户（可选）
• stripe_portal：创建 Stripe Customer Portal 会话并返回其 URL
  • accessToken：创建 Stripe Checkout 会话时获取的访问令牌
  • returnUrl：客户管理订阅后返回的 URL
• stripe_purchases：使用访问令牌获取客户的 Stripe 购买记录
  • accessToken：创建 Stripe Checkout 会话时获取的访问令牌

应用管理

• 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