🚀 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 许可证。