Meta、Instagram、Facebook广告MCP
Brought to you by ArmaVita.com
Need a custom implementation? Contact us.
armavita-meta-ads-mcp 是用于元广告的本地模型上下文协议服务器。 它是为本地MCP客户端（Claude Code、Cursor、Codex）构建的，支持：
- 元访问令牌身份验证(
META_ACCESS_TOKEN) - 本地OAuth流(
META_APP_ID+META_APP_SECRET) - 仅限stdio MCP传输
- python
3.11+ mcp[cli]==1.26.0- 元营销API
v25.0默认情况下(META_GRAPH_API_VERSION支持覆盖）
当前合同版本： 1.1.0.
安装
PyPI（一旦发布）：
pip install armavita-meta-ads-mcp来源（开发期间推荐）：
uv sync跑
armavita-meta-ads-mcp模块入口点：
python -m armavita_meta_ads_mcp登录流程：
armavita-meta-ads-mcp --login快速MCP客户端配置
最小MCP服务器注册（许多客户端使用JSON格式）：
{
"mcpServers": {
"meta-ads-armavita": {
"command": "armavita-meta-ads-mcp",
"env": {
"META_ACCESS_TOKEN": "EA...",
"META_GRAPH_API_VERSION": "v25.0"
}
}
}
}OAuth模式（配置中没有直接令牌）：
{
"mcpServers": {
"meta-ads-armavita": {
"command": "armavita-meta-ads-mcp",
"env": {
"META_APP_ID": "YOUR_APP_ID",
"META_APP_SECRET": "YOUR_APP_SECRET"
}
}
}
}然后运行一次以完成登录：
armavita-meta-ads-mcp --login工具覆盖范围
- 账户：
list_ad_accounts,read_ad_account - 活动：
list_campaigns,read_campaign,create_campaign,update_campaign - 预算时间表：
create_campaign_budget_schedule - 广告集：
list_ad_sets,read_ad_set,create_ad_set,update_ad_set - 广告/创意/媒体：
list_ads,read_ad,list_ad_previews,create_ad,update_ad,list_ad_creatives,read_ad_creative,create_ad_creative,update_ad_creative,upload_ad_image_asset,read_ad_image,export_ad_image_file,search_pages,list_account_pages - 见解/报告：
list_insights,create_report - 瞄准：
search_interests,suggest_interests,estimate_audience_size,search_behaviors,search_demographics,search_geo_locations - 复制：
clone_campaign,clone_ad_set,clone_ad,clone_ad_creative - 广告库：
search_ads_archive - 研究助手：
search_web_content,read_web_content
分页
核心列表/读取流支持基于光标的分页：
list_ad_accounts,list_campaigns,list_ad_sets,list_ads,list_insightslist_ad_creatives,search_interests,suggest_interests,search_behaviors,search_demographics,search_geo_locations,search_ads_archive- 使用
page_cursor随着paging.cursors.after来自先前响应的值。 - 响应保留Meta的本地
paging对象。
见解查询笔记
list_insights和create_report支持：
- date_range 作为 { "since": "YYYY-MM-DD", "until": "YYYY-MM-DD" }，或 - date_range 作为预设（例如 last_30d, maximum).
create_report.comparison_period使用与相同的格式和验证date_range.previous_30d标准化为last_30d.- 对于行动指标，请使用
action_breakdowns（可选summary_action_breakdowns)而不是将动作键混合到breakdowns.
安全
- 访问令牌根据服务器返回的URL字段进行编辑（包括嵌套
paging.nextURL）。
文档
范围
- 此存储库是OSS本地MCP服务器。
- 运输方式为本地
stdio只有。 - 工具别名故意不公开。
许可证
GNU Affero通用公共许可证v3.0（AGPLv3）。看 LICENSE.