三头鲸 MCP 服务器

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

## 功能

- 访问混合统计表数据
- 获取商店信息
- 发现可用指标和维度
- 集成 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
```

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

## 可用工具

- `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)