Appsflyer MCP

🚀 AppsFlyer MCP服務器

AppsFlyer MCP服務器是一個模型上下文協議（MCP）服務器，用於將AppsFlyer分析數據與AI助手集成，為數據分析和應用提供有力支持。

🚀 快速開始

AppsFlyer MCP服務器可幫助你將AppsFlyer的分析數據與AI助手集成。按照以下步驟操作，即可快速啟動並使用該服務器。

✨ 主要特性

• 從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許可證。