AI导哈

广告活动数据报告服务

Jampp MCP服务器通过模型上下文协议提供对Jampp报告API的访问，允许LLMs获取广告活动性能数据。

  • by springwq
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 springwq/jampp_mcp_server

使用说明

Jampp MCP服务器

此MCP服务器通过模型上下文协议提供对Jampp Reporting API的访问，允许LLM获取活动性能数据。

特性

  • 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检查器一起使用

对于开发和测试：

mcp dev jampp_mcp_server.py

与Claude Desktop集成

  1. 从以下位置安装Claude Desktop claude.ai/下载

  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. 重新启动克劳德桌面

可用工具

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：要包括的指标列表（例如[“印象”、“点击”、“支出”]）

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. “创建一份异步报告，其中包含第一季度的活动和国家维度以及展示、点击和支出指标”
  5. “Jampp报告有哪些指标和维度？”

许可证

麻省理工学院

相关 MCP