Jampp MCP Server

Jampp MCP Server

site icon
2025.03.11 0
Python广告活动报告数据分析金融服务
Jampp MCP Server 是一个通过 Model Context Protocol 提供 Jampp Reporting API 访问的服务,允许大型语言模型(LLMs)获取广告活动的性能数据。该服务支持 OAuth 2.0 认证、GraphQL API 集成,并提供广告活动支出报告、每日支出跟踪、全面的性能指标等功能。
View on GitHub

Overview

基本能力

产品定位

Jampp MCP Server 主要用于广告活动的数据报告和分析,帮助用户获取和管理广告活动的性能数据。

核心功能

  • OAuth 2.0 认证,支持自动令牌刷新
  • 基于 GraphQL 的 API 集成
  • 广告活动支出报告
  • 每日支出跟踪
  • 全面的性能指标
  • 异步报告生成和检索
  • 可用指标和维度列表

适用场景

  • 广告活动的支出和性能分析
  • 广告活动的每日支出跟踪
  • 异步报告生成和检索
  • 广告活动的性能指标查询

工具列表

  1. get_campaign_spend:获取特定日期范围内的广告活动支出数据。
  2. get_campaign_daily_spend:获取特定广告活动的每日支出数据。
  3. get_campaign_performance:获取广告活动的全面性能指标。
  4. create_async_report:为大数据集创建异步报告。
  5. get_async_report_status:检查异步报告的状态。
  6. get_async_report_results:获取完成的异步报告结果。
  7. get_available_metrics_and_dimensions:获取所有可用的报告指标和维度列表。

常见问题解答

  • 如何获取广告活动的支出数据?使用 get_campaign_spend 工具。
  • 如何跟踪每日支出?使用 get_campaign_daily_spend 工具。
  • 如何生成异步报告?使用 create_async_report 工具。

使用教程

使用依赖

  • Python 3.10 或更高版本
  • Jampp API 凭证(Client ID 和 Client Secret)

安装教程

  1. 克隆仓库: bash git clone https://github.com/yourusername/mcp-jampp.git cd mcp-jampp

  2. 安装依赖: bash uv add "mcp[cli]" httpx python-dotenv 或使用 pip: bash pip install "mcp[cli]" httpx python-dotenv

  3. 设置环境变量: 在项目根目录创建 .env 文件,内容如下: JAMPP_CLIENT_ID=your_client_id JAMPP_CLIENT_SECRET=your_client_secret

调试方式

  1. 直接运行服务器: bash python jampp_mcp_server.py

  2. 使用 MCP Inspector 进行开发和测试: bash mcp dev jampp_mcp_server.py

  3. 与 Claude Desktop 集成:

  4. 安装 Claude Desktop
  5. 配置 Claude Desktop 使用该服务器
  6. 重启 Claude Desktop

许可证

该项目遵循 MIT 开源许可条款。