Triple Whale MCP Server

Triple Whale MCP Server

Triple Whale API を通じて、Triple Whale のeコマース分析データにアクセスするためのMCP サーバーです。

## 機能

- Blended Stats Table データへのアクセス
- ショップ情報の取得
- 利用可能なメトリクスとディメンションの確認
- テスト用の 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
```

ウェブインターフェースが開き、次の操作ができます：
- カスタム入力で利用可能なすべてのツールをテストする
- 利用可能なリソースを確認する
- サーバーのログとレスポンスを表示する

## 利用可能なツール

- `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 の詳細については、次を参照してください：
- [Blended Stats Table のドキュメント](https://triplewhale.readme.io/docs/blended-stats-table)
- [Triple Whale API リファレンス](https://triplewhale.readme.io/reference/introduction-to-the-triple-whale-api)