Jampp MCP 服务器

此 MCP 服务器通过模型上下文协议提供对 Jampp 报告 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 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. "创建一个异步报告，其中包含广告系列和国家/地区维度，以及第一季度的展示次数、点击次数和花费指标"
5. "Jampp 报告有哪些指标和维度可用？"

许可证

MIT