Jampp_mcp_server

🚀 Jampp MCP 服务器

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

🚀 快速开始

Jampp MCP 服务器能让大型语言模型获取广告系列绩效数据。使用前需确保满足先决条件并完成安装步骤。

✨ 主要特性

• 🔑 带自动令牌刷新功能的 OAuth 2.0 身份验证
• 📊 基于 GraphQL 的 API 集成
• 📈 广告系列支出报告
• 📅 每日支出跟踪
• 📋 全面性能指标
• ⏱️ 异步报告生成和检索
• 📜 可用指标和维度清单

📦 安装指南

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。

可用工具

get_campaign_spend

获取特定日期范围内的广告系列支出数据。

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

get_campaign_performance

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

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

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 许可证。