Jampp MCP Server

Jampp MCP 服务

此 MCP 服务通过模型上下文协议提供对 Jampp Reporting API 的访问，让大模型能够获取广告系列表现数据。

功能

• 支持 OAuth 2.0 身份验证并自动刷新令牌
• 基于 GraphQL 的 API 集成
• 广告系列支出报告
• 每日支出跟踪
• 全面的表现指标
• 异步报告生成与检索
• 可用指标和维度列表

前提条件

• Python 3.10 或更高版本
• Jampp API 凭据（Client ID 和 Client Secret）

安装

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 Inspector

用于开发和测试：

mcp dev jampp_mcp_server.py

与 Claude Desktop 集成

1. 从 claude.ai/download 安装 Claude Desktop

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. 重启 Claude Desktop

可用工具

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：要包含的指标列表（例如 ["impressions", "clicks", "spend"]）

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. “创建一份 Q1 异步报告，包含广告系列和国家/地区维度，以及展示次数、点击次数和支出指标”
5. “Jampp 报告有哪些可用指标和维度？”

许可证

MIT