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