MCP Server for Iaptic

基本能力

产品定位

mcp-server-iaptic 是一个中间件服务器，旨在为 AI 系统（如 Claude）提供与 Iaptic 平台数据交互的能力。它充当了 AI 和 Iaptic API 之间的桥梁，使得 AI 能够查询和处理商业数据。

核心功能

• 客户管理：列出客户和获取客户详细信息
• 购买记录管理：列出购买记录和获取特定购买详情
• 交易管理：列出交易记录和获取特定交易详情
• 统计分析：获取一般统计数据和特定应用的统计数据
• 事件管理：列出近期事件
• 应用管理：切换、重置和查询当前应用

适用场景

• AI 辅助的商业数据分析
• 自动化客户关系管理
• 交易记录查询和分析
• 商业智能报告生成
• 多应用环境下的数据管理

工具列表

1. Customers
2. customer_list: 列出客户

3. customer_get: 通过 ID 获取客户详细信息

4. Purchases

5. purchase_list: 列出购买记录（支持分页、日期过滤和客户 ID 过滤）

6. purchase_get: 通过 ID 获取购买详情

7. Transactions

8. transaction_list: 列出交易记录（支持分页、日期过滤和购买 ID 过滤）

9. transaction_get: 通过 ID 获取交易详情

10. Statistics

11. stats_get: 获取关于交易和收入的一般统计数据

12. stats_app: 获取应用特定统计数据

13. Events

14. event_list: 列出近期事件（支持分页和日期过滤）

15. App Management

16. iaptic_switch_app: 切换到不同的 Iaptic 应用
17. iaptic_reset_app: 重置到默认的 Iaptic 应用
18. iaptic_current_app: 获取当前活动应用的信息

使用教程

使用依赖

• Node.js >= 18
• Iaptic 账户及 API 凭证

安装教程

通过 Smithery 安装

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

手动安装

# 直接运行
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"
    ]
  }
}

调试方式

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 生产构建
npm run build

# 运行生产构建
npm start

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。