Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client