JinDaGe - appsflyer-mcp MCP Details

article

README

🚀 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许可证。

appsflyer-mcp