Jampp MCP Server

Jampp MCP サーバー

この MCP サーバーは、Model Context Protocol を通じて Jampp Reporting API にアクセスし、LLM がキャンペーンのパフォーマンスデータを取得できるようにします。

機能

• トークンの自動更新に対応した OAuth 2.0 認証
• GraphQL ベースの API 統合
• キャンペーンの支出レポート
• 日次支出の追跡
• 包括的なパフォーマンス指標
• 非同期レポートの生成と取得
• 利用可能な指標とディメンションの一覧表示

前提条件

• Python 3.10 以降
• Jampp API の認証情報（Client ID と Client Secret）

インストール

1. このリポジトリをクローンします：

   git clone https://github.com/yourusername/mcp-jampp.git
   cd mcp-jampp
   

2. 依存関係をインストールします：

   uv add "mcp[cli]" httpx python-dotenv
   

   または pip を使用します：

   pip install "mcp[cli]" httpx python-dotenv
   

3. 環境変数を設定します： プロジェクトのルートに .env ファイルを作成し、Jampp API の認証情報を設定します：

   JAMPP_CLIENT_ID=your_client_id
   JAMPP_CLIENT_SECRET=your_client_secret
   

使用方法

サーバーを直接実行する

python jampp_mcp_server.py

MCP Inspector を使用する

開発とテストの場合：

mcp dev jampp_mcp_server.py

Claude Desktop との統合

1. claude.ai/download から Claude Desktop をインストールします

2. このサーバーを使用するよう Claude Desktop を設定します：

   • ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を開くか、作成します
   • 次の設定を追加します：

   {
     "mcpServers": {
       "jampp": {
         "command": "python",
         "args": ["path/to/jampp_mcp_server.py"],
         "env": {
           "JAMPP_CLIENT_ID": "your_client_id",
           "JAMPP_CLIENT_SECRET": "your_client_secret"
         }
       }
     }
   }
   

3. Claude Desktop を再起動します

利用可能なツール

1. get_campaign_spend

指定した期間のキャンペーン支出データを取得します。

パラメーター：

• from_date：YYYY-MM-DD 形式の開始日
• to_date：YYYY-MM-DD 形式の終了日
• campaign_id（任意）：照会する特定のキャンペーンの ID

2. get_campaign_daily_spend

特定のキャンペーンの日次支出データを取得します。

パラメーター：

• from_date：YYYY-MM-DD 形式の開始日
• to_date：YYYY-MM-DD 形式の終了日
• campaign_id：照会するキャンペーンの ID
• timezone（任意）：レポートのタイムゾーン（デフォルト：UTC）

3. get_campaign_performance

キャンペーンの包括的なパフォーマンス指標を取得します。

パラメーター：

• from_date：YYYY-MM-DD 形式の開始日
• to_date：YYYY-MM-DD 形式の終了日
• campaign_id（任意）：照会する特定のキャンペーンの ID
• timezone（任意）：レポートのタイムゾーン（デフォルト：UTC）

4. create_async_report

大規模なデータセット向けの非同期レポートを作成します。

パラメーター：

• from_date：YYYY-MM-DD 形式の開始日
• to_date：YYYY-MM-DD 形式の終了日
• dimensions：含めるディメンションのリスト（例：["campaignId", "campaign"]）
• metrics：含める指標のリスト（例：["impressions", "clicks", "spend"]）

5. get_async_report_status

非同期レポートのステータスを確認します。

パラメーター：

• report_id：確認する非同期レポートの ID

6. get_async_report_results

完了した非同期レポートの結果を取得します。

パラメーター：

• report_id：取得する非同期レポートの ID

7. get_available_metrics_and_dimensions

レポートで利用可能なすべての指標とディメンションのリストを取得します。

Claude への質問例

この MCP サーバーを使用する際に Claude に尋ねられる質問の例を紹介します：

1. 「過去 30 日間のキャンペーン支出を表示してください」
2. 「先週、キャンペーン ID 12345 の日次支出はいくらでしたか？」
3. 「2023 年 1 月の全キャンペーンのパフォーマンス指標を取得してください」
4. 「第 1 四半期について、キャンペーンと国のディメンション、インプレッション、クリック数、支出の指標を含む非同期レポートを作成してください」
5. 「Jampp のレポートで利用できる指標とディメンションは何ですか？」

ライセンス

MIT