Digital Ads Remote MCP

MCP运维云端

提供方 heidrian-eth

运维云端 stdio · 本地进程 Token 社区 / 第三方
查看接入方式

数字广告远程MCP服务是一个云原生的HTTP JSON-RPC服务器,用于远程部署数字广告MCP服务器,支持Google Ads、Google Analytics和Facebook Ads的MCP服务器。

一句话选型结论

按资料字段整理

Digital Ads Remote MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,Token,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

数字广告Python本地部署远程部署云原生HTTPJSON-RPCAPI密钥认证

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
docker run -p 8080:8080 \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Digital Ads Remote MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方heidrian-eth上游标注的维护方 heidrian-eth
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.7 KB
来自项目仓库与上游目录的原文,未做删改

数字广告远程MCP

数字广告MCP服务器的远程部署包装器。目前支持:

  • 谷歌广告MCP → /googleads/mcp
  • 谷歌分析MCP → /analytics/mcp
  • Facebook广告MCP → /facebookads/mcp

特性

  • HTTP JSON-RPC传输:基于云原生HTTP的MCP服务器
  • 无状态架构:无会话存储,可扩展到零
  • API密钥验证:通过API密钥验证客户端
  • 按请求凭据:用户提供自己的平台特定凭据(例如,Google Ads开发者令牌)
  • 多云就绪:部署到任何容器平台
  • 自动更新:使用git子模块跟踪上游变化

建筑

此存储库封装了数字广告MCP服务器(例如 google-ads-mcp)作为git子模块并添加:

  • 远程服务器传输(HTTP JSON-RPC)
  • 身份验证层(API密钥)
  • 凭证注入(按请求平台凭证)
  • 容器部署配置

本地开发```bash

Clone with submodule

git clone --recurse-submodules
cd digital-ads-remote-mcp

Build Docker image

docker build -t digital-ads-remote-mcp .

Run locally for testing

docker run -p 8080:8080 \
-e ALLOWED_API_KEYS="test-key-1,test-key-2" \
-e GOOGLE_APPLICATION_CREDENTIALS="/path/to/credentials.json" \
-v /path/to/credentials.json:/path/to/credentials.json:ro \
digital-ads-remote-mcp


## 部署

### 谷歌云运行```bash
# Build and push to Google Container Registry
gcloud builds submit --tag gcr.io/PROJECT_ID/digital-ads-remote-mcp

# Deploy to Cloud Run
gcloud run deploy digital-ads-remote-mcp \
--image=gcr.io/PROJECT_ID/digital-ads-remote-mcp \
--platform=managed \
--region=us-central1 \
--allow-unauthenticated \
--set-env-vars=ALLOWED_API_KEYS="key1,key2"

AWS Fargate```bash

Build and push to ECR

aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com
docker build -t digital-ads-remote-mcp .
docker tag digital-ads-remote-mcp:latest ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/digital-ads-remote-mcp:latest
docker push ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/digital-ads-remote-mcp:latest

Deploy via AWS CLI (ensure task definition and service exist)

aws ecs update-service \
--cluster your-cluster \
--service digital-ads-remote-mcp \
--force-new-deployment


### Azure容器应用```bash
# Build and push to Azure Container Registry
az acr build --registry YOUR_ACR_NAME --image digital-ads-remote-mcp:latest .

# Deploy to Azure Container Apps
az containerapp create \
--name digital-ads-remote-mcp \
--resource-group YOUR_RESOURCE_GROUP \
--environment YOUR_CONTAINER_APP_ENV \
--image YOUR_ACR_NAME.azurecr.io/digital-ads-remote-mcp:latest \
--target-port 8080 \
--ingress external \
--env-vars ALLOWED_API_KEYS="key1,key2"

加密设置

环境变量可以使用带有secp256k1的ECIES(椭圆曲线集成加密方案)进行加密。

生成密钥对```bash

Install eciespy (uses coincurve under the hood)

pip install eciespy

Generate a new key pair

python3 -c "
from coincurve import PrivateKey
import secrets

sk = PrivateKey(secrets.token_bytes(32))
print(f'Private key (keep secret): {sk.secret.hex()}')
print(f'Public key (for clients): {sk.public_key.format(False).hex()}')
"

Derive public key from an existing hex private key

python3 -c "
from coincurve import PrivateKey
private_key_hex = 'YOUR_PRIVATE_KEY_HEX'
sk = PrivateKey(bytes.fromhex(private_key_hex))
print(sk.public_key.format(False).hex())
"


### 加密值(客户端)```bash
# Encrypt a string
python3 -c "
import ecies
import base64
import sys

public_key = 'YOUR_PUBLIC_KEY_HEX'
plaintext = sys.argv[1]

ciphertext = ecies.encrypt(public_key, plaintext.encode())
print(base64.urlsafe_b64encode(ciphertext).decode().rstrip('='))
" "your-secret-value"

# Encrypt a file
python3 -c "
import ecies
import base64
import sys

public_key = 'YOUR_PUBLIC_KEY_HEX'
with open(sys.argv[1], 'rb') as f:
content = f.read()

ciphertext = ecies.encrypt(public_key, content)
print(base64.urlsafe_b64encode(ciphertext).decode().rstrip('='))
" credentials.json

客户端配置

环境变量通过带有类型前缀的查询参数传递:

前缀 描述 示例
PLAIN_ 明文值 ?PLAIN_FOO=bar → FOO=bar
FILE_ 写入临时文件的内容 ?FILE_CREDS={} → CREDS=/tmp/xxx.json
ENC_ 加密值(base64url) ?ENC_TOKEN=abc... → TOKEN=decrypted
ENCFILE_ 将内容加密到临时文件 ?ENCFILE_CREDS=abc... → CREDS=/tmp/xxx.json

MCP客户端配置```json

{
"mcpServers": {
"google-ads": {
"url": "https://your-service-url/googleads/mcp?api_key=your-api-key&ENC_GOOGLE_ADS_DEVELOPER_TOKEN=abc123...&PLAIN_GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890",
"transport": "http"
},
"google-analytics": {
"url": "https://your-service-url/analytics/mcp?api_key=your-api-key&ENCFILE_GOOGLE_APPLICATION_CREDENTIALS=xyz789...",
"transport": "http"
},
"facebook-ads": {
"url": "https://your-service-url/facebookads/mcp?api_key=your-api-key&ENC_FB_ACCESS_TOKEN=abc123...",
"transport": "http"
}
}
}


### 必需参数

**谷歌广告MCP** (`/googleads/mcp`):

- `GOOGLE_ADS_DEVELOPER_TOKEN`:您的Google Ads API开发者代币
- `GOOGLE_ADS_LOGIN_CUSTOMER_ID`:(可选)经理客户ID
- `GOOGLE_APPLICATION_CREDENTIALS`:(可选)服务帐户JSON路径(使用 `FILE_` 或 `ENCFILE_` 前缀)

**谷歌分析MCP** (`/analytics/mcp`):

- `GOOGLE_APPLICATION_CREDENTIALS`:服务帐户JSON路径(使用 `FILE_` 或 `ENCFILE_` 前缀)
- `GOOGLE_PROJECT_ID`:谷歌云项目ID
- `ANALYTICS_PROPERTY_ID`:(可选)默认GA4属性ID

**Facebook广告MCP** (`/facebookads/mcp`):

- `FB_ACCESS_TOKEN`:Facebook用户访问令牌 `ads_read` 许可(必填)

## 保持最新

MCP服务器作为git子模块包含在内。要更新,请执行以下操作:```bash
# Update all submodules to latest version
git submodule update --remote

# Commit the updates
git add google-ads-mcp google-analytics-mcp facebook-ads-mcp
git commit -m "Update MCP submodules to latest"

# Redeploy to your platform

环境变量

服务器端环境变量:

  • ALLOWED_API_KEYS:以逗号分隔的有效API密钥列表
  • ECIES_PRIVATE_KEY:用于解密的十六进制编码的secp256k1私钥 ENC_* 和 ENCFILE_* 参数

安全考虑

  1. API密钥:存储在平台的秘密管理器中,定期轮换
  2. 开发者代币:从不在服务器端存储,按请求传递
  3. 仅限HTTPS:确保您的平台强制使用HTTPS
  4. 服务账户:使用最低权限访问Google Ads API
  5. 跨域资源共享:配置 allow_origins 生产中

运输

服务器说话 MCP流式HTTP 运输在 POST /{service}/mcp.
会话状态通过以下方式跟踪 Mcp-Session-Id 响应/请求标头:

  1. 第一个请求(initialize)发送时没有会话标头。Env注射
    查询参数(PLAIN_*, FILE_*, ENC_*, ENCFILE_*)在这里阅读和
    配置生成的stdio子进程。
  2. 服务器返回一个 Mcp-Session-Id 头球所有后续请求
    该会议必须包括它。
  3. DELETE /{service}/mcp 使用header关闭会话。

响应返回为 text/event-stream;决赛将带来
JSON-RPC响应。仅通知请求返回 202 Accepted.

测试```bash

Health check

curl https://your-service-url/health

Initialize (captures the Mcp-Session-Id from response headers)

SID=$(curl -sD - -o /dev/null \
-X POST "https://your-service-url/googleads/mcp?api_key=your-api-key&PLAIN_GOOGLE_ADS_DEVELOPER_TOKEN=your-dev-token" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}' \
| awk 'tolower($1)=="mcp-session-id:"{print $2}' | tr -d '\r')

Subsequent calls reuse the session id via the header

curl -X POST "https://your-service-url/googleads/mcp?api_key=your-api-key" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Mcp-Session-Id: $SID" \
-d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

curl -X POST "https://your-service-url/googleads/mcp?api_key=your-api-key" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Mcp-Session-Id: $SID" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Close the session

curl -X DELETE "https://your-service-url/googleads/mcp?api_key=your-api-key" \
-H "Mcp-Session-Id: $SID"
```

故障排除

  • 401未经授权:检查 api_key 查询参数匹配 ALLOWED_API_KEYS
  • 400无效参数:检查加密/解密-确保 ECIES_PRIVATE_KEY 已设置
  • 500内部错误:检查容器日志中的MCP或API错误

许可证

Apache 2.0/MIT(与上游MCP服务器相同:
谷歌广告mcp,
谷歌分析mcp,
脸书广告mcp)

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Digital Ads Remote MCP 怎么安装?

在客户端按下面的安装命令接入:docker run -p 8080:8080 \。装完在客户端配置里引用同一个包或端点。

Digital Ads Remote MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Digital Ads Remote MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Digital Ads Remote MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Digital Ads Remote MCP 能提供哪些能力?

资料显示能力标签包括 远程部署、Python、云原生。具体工具清单以官方文档为准。

Digital Ads Remote MCP 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Digital Ads Remote MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。