Appsflyer MCP

🚀 AppsFlyer MCP Server

AppsFlyerの分析データをAIアシスタントと統合するためのモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• AppsFlyer Pull APIから集計データレポートを取得します。
• 複数のレポートタイプに対応しています：partners_report、partners_by_date_report、daily_report、geo_report、geo_by_date_report
• 安全なAPIトークン認証をサポートします。
• Pydanticを使用した型安全な入力検証が可能です。

📦 インストール

git clone https://github.com/ysntony/appsflyer-mcp
cd appsflyer-mcp
uv sync

📚 ドキュメント

設定

AppsFlyer APIの認証情報を環境変数として設定します：

export APPSFLYER_API_BASE_URL="https://hq1.appsflyer.com"
export APPSFLYER_TOKEN="your_api_token_here"

または、.envファイルを作成します：

APPSFLYER_API_BASE_URL=https://hq1.appsflyer.com
APPSFLYER_TOKEN=your_api_token_here

💻 使用例

基本的な使用法

MCPサーバーの起動

uv run python run_server.py

MCP設定

MCP設定ファイルに以下を追加します：

{
  "mcpServers": {
    "appsflyer": {
      "command": "uv",
      "args": ["run", "python", "run_server.py"],
      "cwd": "/path/to/appsflyer-mcp",
      "env": {
        "APPSFLYER_API_BASE_URL": "https://hq1.appsflyer.com",
        "APPSFLYER_TOKEN": "your_api_token_here"
      }
    }
  }
}

利用可能なツール

• get_aggregate_data：AppsFlyer Pull APIから集計データレポートを取得します。
• test_appsflyer_connection：AppsFlyer APIへの接続をテストします。

レポートタイプ

• partners_report：パートナーのパフォーマンスデータ
• partners_by_date_report：パートナーの日次パフォーマンスデータ
• daily_report：日次集計データ（デフォルト）
• geo_report：地理的なパフォーマンスデータ
• geo_by_date_report：地理的な日次パフォーマンスデータ

開発

uv sync --dev
pytest

📄 ライセンス

MIT License