🚀 Jampp MCP 服务器

Jampp MCP 服务器借助模型上下文协议（Model Context Protocol），为用户提供对 Jampp 报告 API 的访问途径，大型语言模型（LLMs）可通过该服务器获取广告系列绩效数据。

🚀 快速开始

Jampp MCP 服务器允许大型语言模型（LLMs）获取广告系列绩效数据，以下将介绍其使用前的准备和使用方法。

✨ 主要特性

• 具备自动令牌刷新功能的 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 安装：

   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_performance

获取广告系列的性能数据。 参数：

• from_date：起始日期，格式为 YYYY - MM - DD
• to_date：结束日期，格式为 YYYY - MM - DD
• campaign_id（可选）：广告系列 ID

3. generate_report

生成自定义报告。 参数：

• report_type：报告类型（例如，'daily', 'weekly', 'monthly'）
• from_date：起始日期，格式为 YYYY - MM - DD
• to_date：结束日期，格式为 YYYY - MM - DD

示例查询

# 获取广告系列支出
python -m mcp_server get_campaign_spend --from_date 2023-01-01 --to_date 2023-12-31

# 获取广告系列性能
python -m mcp_server get_campaign_performance --campaign_id 12345 --from_date 2023-01-01 --to_date 2023-12-31

# 生成月度报告
python -m mcp_server generate_report --report_type monthly --from_date 2023-01-01 --to_date 2023-12-31

📄 许可证

本项目遵守 MIT 许可证。