MCP Server for Iaptic

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

安装

通过Smithery安装

要通过Smithery自动安装Iaptic for Claude Desktop：

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

手动安装

# 直接使用npx运行
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：要切换的应用名称
  • apiKey：该应用的API密钥
• iaptic_reset_app：重置为默认的Iaptic应用
• iaptic_current_app：获取当前激活应用的信息

开发

# 安装依赖
npm install

# 在开发模式下运行
npm run dev

# 构建生产环境
npm run build

# 运行生产构建
npm start

要求

• Node.js >= 18
• 带有API凭证的Iaptic账户

许可证

MIT