Armavita Meta Ads Mcp

ArmaVita Meta Ads MCP

通过 Claude Code、Codex 或其他兼容 MCP 的助手管理 Facebook、Instagram 和 Threads 广告。

我们打造此工具，是为了实现快速启动、低内存占用，并通过一个本地服务广泛覆盖广告相关功能。 125 个工具涵盖广告系列、报告、潜在客户表单、目录、受众等功能，响应精简，并为敏感更改提供防护。相关操作共用工具，让工具列表保持精简。

它以单个可执行文件的形式运行，无需维护 Python 环境，并使用 Meta Marketing API v26。

**Rust 2.0 候选发布版：**已通过冒烟测试，并在内部得到大量使用。 如果遇到任何问题，请报告。

你可以做什么

领域	功能
广告	广告系列、广告组、创意、预览、预算、排期和投放检查
报告	成效数据、筛选器、归因设置、细分、异步报告和更改历史记录
潜在客户	创建和归档即时表单、获取提交内容、测试潜在客户以及管理 Webhook 订阅
受众	自定义受众和类似受众、已保存受众查找、定向、上传和共享
自动化	规则、A/B 测试、价值规则和建议
目录	产品、集合、数据源、批量更新、诊断和目录广告设置
创意素材	账户和主页媒体、可玩广告、标签和即时体验
互动	Facebook/Instagram 广告评论和受支持的 Threads 广告回复
衡量与访问权限	像素、数据集、CAPI、自定义转化、商务资产、权限和发布商屏蔽名单

仍需满足 Meta 的权限和账户资格要求。设置与限制。

为什么用 Rust 重建

我们用 Rust 重建了 Python 服务，以实现更快的 启动、更低的内存占用，并提供无需维护 Python 环境的单个可执行文件。

指标	Python	Rust	提升
启动时间	512 ms	8.17 ms	快约 63 倍
空闲内存	77.84 MiB	16.30 MiB	减少约 79%
运行时磁盘空间	45.7 MiB	7.97 MiB	缩小约 83%

原始重写基准数据，于 2026 年 8 月 20 日在 macOS arm64 上测得。启动时间采用预热运行的中位数；在此基准测试中，加载工具定义的速度较慢。完整结果和方法。

重建版本还确保凭据不会出现在工具调用中，并新增了可在应用前审核的写入计划。查看与 Python 版本相比的变化。

开始使用

1. 安装

从 rust 分支检出代码，或解压源码发布包后进行源码构建，需要 Rust 1.98.0、C/C++ 编译器和 CMake：

cargo install --locked --path .

2. 身份验证

在用于启动 MCP 客户端的环境中设置 META_ACCESS_TOKEN。令牌需要具备相应的 Meta 权限，并能访问你要管理的广告账户。

如果要改用浏览器登录，请设置 META_APP_ID 和 META_APP_SECRET，然后运行：

armavita-meta-ads-mcp --login

浏览器登录会在 macOS/Linux 上保存私有的本地令牌缓存。在 Windows 上，请使用 META_ACCESS_TOKEN。 切勿将凭据放入提示词或已提交的配置文件中。

3. 连接助手

对于使用 JSON MCP 配置的客户端，请添加：

{
  "mcpServers": {
    "meta-ads-armavita": {
      "command": "armavita-meta-ads-mcp",
      "args": ["--transport=stdio"]
    }
  }
}

Claude Code 可以使用随附的 .mcp.json。对于 Codex，请使用 TOML 配置示例。

完整设置指南：权限、身份验证、客户端设置和媒体上传。

更改在线广告之前

请在 MCP 客户端中保持启用写入审批。应用变更之前，请先审核变更计划； 删除操作需要明确确认。服务不会自动重试写入操作。

本地上传默认关闭。如需启用，请将 META_MEDIA_ROOT 设置为你控制的文件夹。 详情请参阅安全指南。

从 Python 版本迁移？部分工具名称、输入和结果已更改。 切换之前，请阅读迁移指南。

许可证

版权所有 (c) ArmaVita LLC。仅限 GNU AGPLv3（AGPL-3.0-only）。按现状分发，不提供任何担保。