Jampp MCP Server

🚀 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 許可證。