返回 MCP 目录
public公开dns本地运行

TripleWhale-MCP-Server

一个用于通过Triple Whale API访问电商分析数据的MCP服务器,提供混合统计数据、店铺信息、可用指标和维度查询等功能。

article

README

🚀 三头鲸 MCP 服务器

这是一个借助 Triple Whale API 来访问 Triple Whale 电商分析数据的 MCP 服务器。它能帮助用户轻松获取电商相关的统计数据、商店信息等,为电商数据分析提供便利。

🚀 快速开始

本服务器可通过 Triple Whale API 访问电商分析数据,以下是使用前的准备步骤。

✨ 主要特性

  • 访问混合统计表数据,助您全面了解电商数据情况。
  • 获取商店信息,掌握商店的基本详情。
  • 发现可用指标和维度,为数据分析提供更多方向。
  • 集成 MCP 检查器进行测试,确保服务器的正常运行。

📦 安装指南

  1. 克隆此仓库。
  2. 安装依赖:
    npm install
    
  3. 创建一个 .env 文件,添加你的 Triple Whale API 凭证:
    TRIPLE_WHALE_API_KEY=your_api_key_here
    TRIPLE_WHALE_SHOP_ID=your_shop_id_here
    
  4. 运行服务器:
    npm run dev
    

💻 使用示例

基础用法

使用 MCP 检查器进行测试

要使用 MCP 检查器测试服务器:

npm run inspect

这将打开一个网络界面,你可以:

  • 使用自定义输入测试所有工具。
  • 浏览可用资源。
  • 查看服务器日志和响应。

高级用法

获取混合统计数据

{
  "dateRange": {
    "start": "2023-01-01",
    "end": "2023-01-31"
  },
  "metrics": [
    {
      "id": "revenue"
    },
    {
      "id": "orders"
    }
  ],
  "dimensions": [
    {
      "id": "utm_source"
    }
  ],
  "limit": 10
}

📚 详细文档

可用工具

  • get_blended_stats:获取 Triple Whale 的混合统计数据。
  • get_shop_info:获取配置商店的信息。
  • get_available_metrics:获取商店的可用指标列表。
  • get_available_dimensions:获取商店的可用维度列表。

可用资源

  • triplewhale://shop:配置商店的信息。
  • triplewhale://metrics:可用指标的列表。
  • triplewhale://dimensions:可用维度的列表。

📄 API 文档

更多关于 Triple Whale API 的信息,请参阅:

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端