modelscope·@ivan-rivera-projects/Klaviyo-MCP-Server-Enhanced
暂无描述。
一个全面的模型上下文协议(MCP)服务器,用于与Klaviyo API交互。这个增强版本提供了高级分析功能、性能优化和强大的错误处理机制,同时保持与原始MCP服务器的完全兼容性。
这个增强版本增加了原版中没有的强大分析能力:
src/config.js) 用于所有API参数这个增强版本使用了Klaviyo API修订版2024-06-15,其中包括最新的特性和改进。该服务器通过集中式配置系统设计为与未来的API修订版前向兼容。
这个项目是基于Matt Coatsworth创建的原始Klaviyo MCP服务器的增强版本。原始工作为这个增强版本奠定了基础。
当你首次使用此 MCP 工具启动 Claude Desktop 时,你会看到几个 JSON 解析错误通知。这是正常且预期的行为。
这些警告发生在 Claude 与 MCP 服务器初次连接期间,并不会影响工具的功能。一旦 Claude 完全初始化,这些警告将不再出现,工具将正常工作。
需要记住的关键点:
有关这些警告的更多技术细节,请参阅 STARTUP_ERROR_SUPPRESSION.md。
要通过 Smithery 自动安装 Klaviyo 增强版分析服务器:
bash npx -y @smithery/cli install @ivan-rivera-projects/Klaviyo-MCP-Server-Enhanced --client claude
克隆此仓库: bash git clone https://github.com/ivan-rivera-projects/Klaviyo-MCP-Server-Enhanced.git cd Klaviyo-MCP-Server-Enhanced
安装依赖项: bash npm install
根据 .env.example 创建一个 .env 文件:
bash
cp .env.example .env
编辑 .env 文件以添加你的 Klaviyo API 密钥:
KLAVIYO_API_KEY=your_private_api_key_here LOG_LEVEL=info LOG_FILE=/tmp/klaviyo-mcp.log LOG_RESPONSES=false NODE_ENV=development
以开发模式启动服务器并启用自动重载: bash npm run dev
用于生产环境: bash npm start
你可以使用 MCP 检查器来测试服务器:
bash npm run inspect
这将打开一个网页界面,你可以在其中测试所有可用的工具和资源。
有关分析功能和 API 参数的详细信息,请参阅:
javascript // 获取活动的打开率和点击率 get_campaign_metrics({ id: "01JSQRND0PMH88186NREAJEGGN", metrics: ["open_rate", "click_rate", "delivered", "bounce_rate"], conversion_metric_id: "VevE7N", // 下单指标 ID start_date: "2025-04-01T00:00:00Z", // 可选:自定义日期范围 end_date: "2025-05-01T00:00:00Z" // 可选:自定义日期范围 })
javascript // 按月统计下单数量 query_metric_aggregates({ metric_id: "VevE7N", // 下单指标 ID measurement: "count", group_by: ["month"], timeframe: "last_30_days", // 预定义时间范围 // 或者使用自定义日期: start_date: "2025-01-01T00:00:00Z", end_date: "2025-05-01T00:00:00Z" })
javascript // 获取活动的全面性能摘要 get_campaign_performance({ id: "01JSQRND0PMH88186NREAJEGGN" })
get_campaign_metrics: 获取特定活动的性能指标(如打开率、点击率等)query_metric_aggregates: 查询自定义分析报告的聚合指标数据get_campaign_performance: 获取活动的全面性能摘要get_campaigns: 从 Klaviyo 获取活动get_campaign: 从 Klaviyo 获取特定活动- get_campaign_message: 获取带有模板详情的特定活动消息get_campaign_messages: 获取特定活动的所有消息get_campaign_recipient_estimation: 获取活动的预估接收者数量get_profiles: 从Klaviyo获取用户档案get_profile: 从Klaviyo获取特定用户档案create_profile: 在Klaviyo中创建新的用户档案update_profile: 更新Klaviyo中的现有用户档案delete_profile: 从Klaviyo删除用户档案get_lists: 从Klaviyo获取列表get_list: 从Klaviyo获取特定列表create_list: 在Klaviyo中创建新列表add_profiles_to_list: 将用户档案添加到Klaviyo中的列表get_segments: 从Klaviyo获取分段get_segment: 从Klaviyo获取特定分段get_events: 从Klaviyo获取事件create_event: 在Klaviyo中创建新事件get_metrics: 从Klaviyo获取指标get_metric: 从Klaviyo获取特定指标get_flows: 从Klaviyo获取流程get_flow: 从Klaviyo获取特定流程update_flow_status: 更新Klaviyo中流程的状态get_templates: 从Klaviyo获取模板get_template: 从Klaviyo获取特定模板create_template: 在Klaviyo中创建新模板get_images: 从Klaviyo获取图片get_image: 从Klaviyo获取特定图片get_catalogs: 从Klaviyo获取目录get_catalog_items: 从Klaviyo中的目录获取项目get_catalog_item: 从Klaviyo中的目录获取特定项目get_coupons: 从Klaviyo获取优惠券create_coupon_code: 在Klaviyo中创建新的优惠码get_tags: 从Klaviyo获取标签create_tag: 在Klaviyo中创建新标签add_tag_to_resource: 向Klaviyo中的资源添加标签get_webhooks: 从Klaviyo获取Webhookcreate_webhook: 在Klaviyo中创建新的Webhookdelete_webhook: 从Klaviyo删除Webhookrequest_profile_deletion: 请求删除用户档案以符合数据隐私合规性get_forms: 从Klaviyo获取表单get_form: 从Klaviyo获取特定表单get_product_reviews: 从Klaviyo获取产品评价get_product_review: 从Klaviyo获取特定产品评价klaviyo://profile/{id}: 获取关于特定用户档案的信息klaviyo://list/{id}: 获取关于特定列表的信息klaviyo://segment/{id}: 获取关于特定分段的信息klaviyo://campaign/{id}: 获取关于特定活动的信息klaviyo://flow/{id}: 获取关于特定流程的信息klaviyo://template/{id}: 获取关于特定模板的信息暂无描述。
暂无描述。
一种MCP服务器实现,它将克劳德与Salesforce集成在一起, enables使用自然语言与Salesforce数据和元数据进行交互,以查询、修改和管理对象和记录。
一种MCP服务器实现,它将克劳德与Salesforce集成,从而能够以自然语言与Salesforce的数据和元数据进行交互,以查询、修改和管理对象和记录。
暂无描述。
暂无描述。