🚀 Iaptic 的 MCP 服务器

这是一个用于与 Iaptic API 交互的模型上下文协议 (MCP) 服务器。借助此服务器，Claude 或其他 AI 系统能够依据你的 Iaptic 数据，回答有关客户、购买、交易和统计信息等方面的问题。

🚀 快速开始

此服务器可助力 Claude 或其他 AI 系统利用 Iaptic 数据进行相关问题的解答。下面为你介绍具体的安装和使用方法。

📦 安装指南

你可以选择直接使用 npx 运行，也可以进行全局安装。

# 直接使用 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 结合使用，需将以下内容添加到你的 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: 获取应用程序特定的统计信息

🔧 技术细节

开发

如果你想对该项目进行开发，可以按照以下步骤操作：

# 安装依赖项
npm install

# 以开发模式运行
npm run dev

# 构建生产版本
npm run build

# 运行生产构建
npm start

要求

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

📄 许可证

本项目采用 MIT 许可证。