stackadapt-mcp

一个用于查询 StackAdapt GraphQL API 的 MCP (Model Context Protocol) 服务器。让 Claude 等 AI 助手能够直接访问您的广告系列数据、投放指标、广告主信息等。

工具

Related MCP server: GraphQL MCP Server

设置

获取您的 API 密钥

从以下位置获取 StackAdapt API 密钥：StackAdapt 平台 → 设置 → API。

Claude Desktop

添加到您的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "stackadapt": {
      "command": "npx",
      "args": ["-y", "stackadapt-mcp"],
      "env": {
        "STACKADAPT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

添加到您项目的 .mcp.json 中：

{
  "mcpServers": {
    "stackadapt": {
      "command": "npx",
      "args": ["-y", "stackadapt-mcp"],
      "env": {
        "STACKADAPT_API_KEY": "${STACKADAPT_API_KEY}"
      }
    }
  }
}

然后在您的 shell 中设置环境变量：export STACKADAPT_API_KEY=your-api-key-here

数据说明

关于 StackAdapt API 的几点注意事项：

• cost、ecpc、ecpm、ecpe 返回为字符串 — 请将其解析为浮点数

• ctr 已经是百分比值（0.214 表示 0.214%） — 请勿乘以 100

• ecpe 在没有互动量的期间返回 "0"

• 投放负载 是 GraphQL UNION 类型（Outcome | Progress） — 大型查询可能会返回带有作业 ID 的 Progress 响应；请在几秒钟后重试

• 粒度选项：DAILY（每日）、WEEKLY（每周）、MONTHLY（每月）、TOTAL（总计）

开发

git clone https://github.com/aymanshaikh/stackadapt-mcp.git
cd stackadapt-mcp
npm install
npm run build

要进行本地测试，请设置 STACKADAPT_API_KEY 并运行：

STACKADAPT_API_KEY=your-key node dist/index.js

许可证

MIT