Jampp MCP Server

🚀 Jampp MCP サーバー

このMCPサーバーは、モデルコンテキストプロトコル（Model Context Protocol）を通じてJamppレポートAPIへのアクセスを提供し、大規模言語モデル（LLMs）がキャンペーンのパフォーマンスデータを取得できるようにします。

✨ 主な機能

• OAuth 2.0認証（自動トークンリフレッシュ機能付き）
• GraphQLベースのAPI統合
• キャンペーン支出レポート
• 毎日の支出追跡
• 包括的なパフォーマンス指標
• 非同期レポート生成と検索
• 利用可能な指標と次元のリスト

📦 インストール

前提条件

• Python 3.10以上
• Jampp APIの認証情報（クライアントIDとクライアントシークレット）

インストール手順

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をこのサーバーを使用するように設定します：

• macOSの場合は~/Library/Application Support/Claude/claude_desktop_config.json、Windowsの場合は%APPDATA%\Claude\claude_desktop_config.jsonを開くか作成します。
• 以下の設定を追加します：

{
    "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_performance

キャンペーンのパフォーマンスデータを取得します。 パラメータ：

• from_date：開始日付（YYYY-MM-DD形式）
• to_date：終了日付（YYYY-MM-DD形式）
• campaign_id（オプション）：キャンペーンID

3. generate_report

カスタムレポートを生成します。 パラメータ：

• report_type：レポートの種類（例：'daily', 'weekly', 'monthly'）
• from_date：開始日付（YYYY-MM-DD形式）
• to_date：終了日付（YYYY-MM-DD形式）

クエリの例

# キャンペーン支出を取得する
python -m mcp_server get_campaign_spend --from_date 2023-01-01 --to_date 2023-12-31

# キャンペーンのパフォーマンスを取得する
python -m mcp_server get_campaign_performance --campaign_id 12345 --from_date 2023-01-01 --to_date 2023-12-31

# 月次レポートを生成する
python -m mcp_server generate_report --report_type monthly --from_date 2023-01-01 --to_date 2023-12-31

📄 ライセンス

このプロジェクトはMITライセンスに準拠しています。