Triplewhale MCP Server

🚀 三头鲸 MCP サーバー

このサーバーは、Triple Whale API を通じて Triple Whale の電子商取引分析データにアクセスするための MCP サーバーです。

🚀 クイックスタート

このサーバーを使用することで、Triple Whale の電子商取引分析データにアクセスできます。以下の手順に従ってサーバーをセットアップしてください。

✨ 主な機能

• 混合統計表データにアクセス
• ショップ情報を取得
• 利用可能な指標と次元を発見
• 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

これにより、Web インターフェースが開き、以下のことができます。

• カスタム入力を使用してすべてのツールをテスト
• 利用可能なリソースを閲覧
• サーバーのログとレスポンスを確認

混合統計データの取得

{
  "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：利用可能な次元のリスト

📚 ドキュメント

Triple Whale API に関する詳細情報は、以下を参照してください。

• 混合統計表ドキュメント
• Triple Whale API リファレンスドキュメント