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

1. 安装依赖项：

   uv add "mcp[cli]" httpx python-dotenv

或者使用pip：

   pip install "mcp[cli]" httpx python-dotenv

1. 设置环境变量：

创建一个 .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/下载

1. 配置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"
         }
       }
     }
   }

1. 重新启动克劳德桌面

可用工具

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报告有哪些指标和维度？”

许可证

麻省理工学院