Triple Whale MCP 服务器

一个用于通过 Triple Whale API 访问 Triple Whale 电子商务分析数据的 MCP 服务器。

## 功能

- 访问混合统计表数据
- 商店信息检索
- 可用指标和维度发现
- MCP Inspector 集成用于测试

## 设置

1. 克隆此仓库
2. 安装依赖项：
   ```
   npm install
   ```
3. 创建一个包含您的 Triple Whale API 凭据的 `.env` 文件：
   ```
   TRIPLE_WHALE_API_KEY=your_api_key_here
   TRIPLE_WHALE_SHOP_ID=your_shop_id_here
   ```
4. 运行服务器：
   ```
   npm run dev
   ```

## 使用 MCP Inspector 进行测试

要使用 MCP Inspector 测试服务器：

```
npm run inspect
```

这将打开一个 Web 界面，您可以在其中：
- 使用自定义输入测试所有可用工具
- 浏览可用资源
- 查看服务器日志和响应

## 可用工具

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

## 可用资源

- `triplewhale://shop`: 有关配置商店的信息
- `triplewhale://metrics`: 可用指标列表
- `triplewhale://dimensions`: 可用维度列表

## 使用示例

### 获取混合统计数据

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

## API 文档

有关 Triple Whale API 的更多信息，请参阅：
- [混合统计表文档](https://triplewhale.readme.io/docs/blended-stats-table)
- [Triple Whale API 参考](https://triplewhale.readme.io/reference/introduction-to-the-triple-whale-api)