MCP Server for Iaptic

一个用于与Iaptic API交互的模型上下文协议服务器。此服务器允许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

与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: 获取当前活动应用的信息

开发

# 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