Skip to main content
Glama

为什么选择 Open MCP Servers

Open MCP Servers 是自托管 Model Context Protocol (MCP) 连接器的家园。您可以将服务器运行在自己的机器或基础设施上,连接到兼容 MCP 的 AI 客户端,并将凭据和应用程序数据保留在自己的掌控之中。

本仓库目前包含一个生产就绪的 Meta 连接器,覆盖 Facebook Pages、Instagram、Threads、Ads Manager、Commerce、Conversions API、受众和洞察。连接器架构特意保持简单直接,使社区能够为其他应用程序添加连接器,而无需依赖托管网关或供应商控制的中间层。

您可以依据 MIT License 自由地使用、修改、复刻、托管和重新分发本项目。您需要对所连接的第三方应用程序的凭据、API 访问、托管环境和服务条款负责。

“连接任意应用程序”意味着什么

MCP 在 AI 客户端和服务器之间提供了标准接口,但每个应用程序仍然需要一个了解其 API、身份验证和操作方式的连接器。您以附带的 Meta 连接器为参考,再为要支持的应用程序添加新的 API 客户端和工具模块即可。

本项目不会将您的凭据发送到任何中心服务,也不需要订阅。

Related MCP server: Meta Marketing API MCP Server

随附连接器:Meta

管理 Meta 各个平台的社交媒体运营——Facebook Pages、Instagram、Threads、Ads Manager 和 Commerce——需要同时应付多个仪表盘,每个平台都有各自的 API 特性和令牌流程。随附的连接器将这些 API 整合到一个 MCP 接口中,让您的 AI 助理可以跨平台发布内容、分析成效、管理广告活动和运营互动,而不必来回切换。

每个工具都会返回可操作的错误信息,而不是难以理解的 API 状态码。令牌过期?您会看到生成新令牌的链接。缺少权限?它会把缺哪个权限、在哪里授予都清清楚楚地列出来。这意味着您不必灰头土脸地调试,而是可以把时间花在真正的事情上。

快速开始

使用 MCPB 安装

对于 Claude Desktop 等兼容 MCP-的 and 通过MCPB 客户端,可从最新发布页 下载本地工具包(当有可用版本时):

下面的 npm 包和源码安装方式,是最灵活、最适合自托管的选项。

该压缩包中包含 Meta favicon、生产运行环境依赖,以及 Meta 和可选 Threads 访问令牌的设置提示。

将其添加到您的 MCP 客户端配置中:

{
  "mcpServers": {
    "meta": {
      "command": "npx",
      "args": ["-y", "@oliverames/meta-mcp-server"],
      "env": {
        "META_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

就这么简单。您的 AI 助手现在可以通过一个由您掌控的服务器使用全部 200 个 Meta 工具。

需要令牌?前往 Graph API Explorer,选择您的应用并生成一个即可。详见配置

从源码安装

git clone https://github.com/open-work-org/open-mcp-servers.git
cd open-mcp-servers
npm install && npm run build

编译后的服务器通过 stdio 协议通信,因此它可与任何支持本地 stdio 服务器的 MCP 客户端配合使用。自托管是默认的部署方式;本仓库不需要托管的账户,也不需要进行项目注册。


你可以做什么

随处发布

发布到 Facebook Pages(文字、照片、视频、Reels、Stories)、Instagram(照片、Reels、Stories、旋转)和 Threads(文字、图片、视频、GIF、链接)。您可以提前定时发布,或在一个调用中实现多平台转发。

> Post our holiday hours to the Facebook page
> Schedule an Instagram carousel for tomorrow at 9am
> Cross-post this photo to both Facebook and Instagram
> Publish a GIF to Threads with reply controls
> Create a Facebook Reel from this video
> Post a Story to our Facebook page
> Publish an Instagram reel with alt text for accessibility
> Share a link post on Threads with a quote

管理互动

跨平台阅读和回复评论,零回收隐藏不宜显示的内容而不删除,管理 Instagram 私信和广播频道,并为自己不在时可以设置自动回复。

> Show me unanswered Instagram DMs
> Hide that offensive comment on our latest post
> Reply to the top 3 comments on yesterday's reel
> Set up an instant reply for new messages
> Set our away message to "Back Monday at 9am"
> Send a DM to that customer who reached out
> What comments did we get on last week's posts?
> Update our Messenger greeting text

分析成效

获取每一个层级的洞察——主页、帖子、账号、广告系列、广告组和单条广告。超过 70 项主页指标、全面的 Reels 分析(包括跳过率、跨平台浏览量),以及包含视频完播率、ROAS 和质量排名的完整广告效果。并把生成图表带入报告。

> How did our Instagram perform this month?
> Show campaign spend broken down by age group
> What's the skip rate on our latest Reel?
> Generate a bar chart comparing this week vs last
> Get our Facebook page fan demographics
> What's our follower growth trend over 90 days?
> Show me post-level engagement for our top 5 posts
> Create a pie chart of spend by campaign

运营投放

覆盖广告系列的全生命周期——创建、优化、测试和自动化。带可信度水平的 A/B 测试、Advantage+ 购物迁移、兴趣/地理位置/人口特征定向搜索、触达预估、自动化规则,以及包含服务器端 Conversions API 的完整像素管理。

> Create an A/B test comparing these two ad sets
> Migrate this campaign to Advantage+ Shopping
> Send a purchase conversion event via CAPI
> What's the reach estimate for women 25-34 in NYC?
> List all active campaigns and their ROAS
> Create an automated rule: pause ads over $5 CPA
> Check if our pixel is firing correctly
> Upload this image for a new ad creative

管理电商

对 Facebook 和 Instagram 商店实现完整的产品目录管理——添加商品、更新库存、整理系列、管理上架状态。品牌在社交电商中需要的一切,这里都有。

> List all products in our catalog
> Add this new product at $29.99, in stock
> Mark the seasonal items as out of stock
> Show me our "Summer Collection" product set
> Update the description on our best-selling item
> How many products are in each catalog?
> Delete the discontinued product line
> What products are currently available?

开启直播

为产品发布和活动安排 Facebook Live 直播,发布 Stories 用于在线内容,并通过 Instagram 广播频道,在聊天框中使用有投票、链接和消息进行播报,直接触达您的受众。

> Start a live video on our Facebook page
> Send a poll to our Instagram broadcast channel
> Schedule a live stream for Friday at 2pm
> Publish a story to Facebook with this photo
> End the live broadcast
> Send a product announcement to our broadcast channel
> What live videos have we done this month?
> What ads is our competitor running right now?

研究竞争对手

通过 Meta 公开广告资料库,搜索任意广告主正在投放的广告,查看他们的创意、定向和花费——无需对方授权。也能查看任何公开的 Instagram 企业账号数据。

> What ads is Nike running in the US right now?
> Search the Ad Library for "sustainable fashion" ads
> Look up @competitor on Instagram — followers and posts
> Show me all active ads by this page ID
> What platforms are they running ads on?
> How much is our competitor spending on ads?

保持掌控

调试令牌、检查权限、监测速率限制、验证像素误、误、管理和以及管理您的 Business Manager 资源。每一次错误都会明确告诉您哪里出了问题以及如何修复——绝不用难以理解的报错。

> Check my token status and permissions
> Am I close to Instagram's publishing limit?
> Run a health check on the Meta connection
> Is our pixel receiving events?
> List all ad accounts in our Business Manager
> Share this pixel with our agency's ad account
> What Threads rate limits do we have left?
> Debug why this API call is failing

完整工具参考

Facebook Pages — 52 个工具

Facebook Pages — 52 个工具

Tool

描述

meta_list_pages

列出你管理的所有 Facebook 主页 (请先调用 —— 会缓存主页令牌)

meta_get_page

获取主页详细信息(类别、关注者、描述、链接)

meta_get_post

按 ID 获取单篇帖子

meta_create_post

在主页上创建文本帖子

meta_create_photo_post

创建照片帖子(通过 URL 或主页照片 ID)

meta_create_video_post

创建视频帖子(可带标题和描述)

meta_update_post

编辑已有帖子的内容

meta_delete_post

删除帖子

meta_get_posts

分页获取主页信息流

meta_get_published_posts

仅获取已发布的帖子

meta_get_scheduled_posts

获取定时(未发布)的帖子

meta_get_promotable_posts

获取可进行广告推广的帖子

meta_get_visitor_posts

获取访客在主页上发布的帖子

meta_get_post_comments

分页获取帖子的评论

meta_reply_post_comment

以主页身份回复评论

meta_delete_comment

删除评论

meta_hide_comment

隐藏或取消隐藏评论(非破坏性审核)

meta_like_object

为帖子或评论点赞或取消点赞

meta_get_post_reactions

获取表情回应明细(赞、喜爱、哈哈、惊讶、悲伤、愤怒)

meta_get_page_insights

主页分析 —— 覆盖展示量、互动、粉丝、视频等 70 多项指标

meta_get_post_insights

单篇分析(展示量、互动、点击量、表情回应、视频)

meta_get_page_conversations

列出主页的消息会话

meta_get_conversation_messages

获取会话中的消息

meta_send_page_message

向用户发送消息(24 小时消息窗口)

meta_update_page

更新主页详情(简介、描述、网站、营业时间、用户名、类别、地址)

meta_update_page_picture

通过 URL 更新主页头像

meta_update_page_cover

通过 URL 或已有照片更新主页封面

meta_create_event

创建主页活动

meta_get_page_events

列出活动(即将开始、已结束或已取消)

meta_get_page_albums

列出主页相册

meta_get_page_photos

获取照片(已上传或已标记)

meta_get_page_videos

列出主页视频

meta_get_page_tagged

获取主页被标记的帖子

meta_get_page_fan_demographics

按年龄、性别、国家统计粉丝分布

meta_get_page_ratings

获取主页评价与星级评分

meta_get_page_locations

获取多门店企业的位置信息

meta_get_page_cta

获取主页的行动号召按钮配置

meta_get_page_tabs

列出主页页签及其配置

meta_get_page_picture

获取主页头像 URL

meta_get_blocked_users

列出被屏蔽用户

meta_block_user

屏蔽或取消屏蔽用户

meta_subscribe_page_webhooks

订阅主页的 webhook 事件

meta_publish_page_story

发布 Facebook 快拍(照片或视频)

meta_publish_page_reel

发布 Facebook Reel

meta_cross_post

同时交叉发布到 Facebook + Instagram

meta_create_live_video

开始或定时创建直播

meta_get_live_videos

列出主页的直播视频

meta_end_live_video

结束正在进行的直播

meta_get_page_automated_responses

获取当前的自动回复设置

meta_set_instant_reply

设置即时回复消息

meta_set_away_message

设置离开 / 外出留言

meta_set_greeting

设置 Messenger 问候语文本

Instagram — 37 个工具

完整的 Instagram Business API —— 支持定时发布、私信、广播频道、互动、发现和数据分析。

工具

描述

meta_list_instagram_accounts

列出与你的 Facebook Pages 关联的 Instagram 商业账户

meta_get_instagram_media

带分页获取 Instagram 账户的近期媒体

meta_get_instagram_single_media

按 ID 获取单个媒体对象

meta_publish_instagram_photo

发布照片,可设置可选替代文本并支持定时发布

meta_publish_instagram_reel

发布 Reels,支持自动轮询和可选定时发布

meta_publish_instagram_story

发布快拍(图片或视频,支持自动轮询)

meta_publish_instagram_carousel

发布轮播(2–10 项,并行处理,可定时发布)

meta_publish_instagram_container

发布预先创建的媒体容器

meta_check_instagram_container

检查容器处理状态,并提供可操作信息

meta_get_instagram_account_insights

账户级分析,含人口统计细分

meta_get_instagram_media_insights

单条帖子指标,包括 Reels 跳过率和跨平台转载观看次数

meta_get_instagram_comments

获取媒体对象上的评论

meta_get_instagram_comment_replies

获取评论的嵌套回复

meta_reply_instagram_comment

回复评论

meta_delete_instagram_comment

删除评论

meta_hide_instagram_comment

隐藏/取消隐藏评论(非破坏性审核)

meta_search_instagram_catalog_products

在 Instagram Shopping 目录中按名称搜索产品

meta_search_instagram_hashtag

搜索话题标签的热门媒体或近期媒体

meta_get_instagram_recent_hashtags

获取你最近搜索过的话题标签

meta_get_instagram_user

商业发现 — 通过用户名查找任何公开的企业/创作者

meta_get_instagram_stories

获取当前活跃的快拍

meta_get_instagram_live_media

获取直播视频媒体

meta_get_instagram_mentioned_media

获取你被 @提及的媒体

meta_get_instagram_media_children

获取轮播中的单个项目

meta_get_instagram_product_tags

获取媒体对象上的产品标签

meta_delete_instagram_media

删除媒体对象

meta_toggle_instagram_comments

启用或禁用媒体评论

meta_check_instagram_publishing_limit

检查速率限制状态(每 24 小时 100 条帖子)

meta_get_instagram_conversations

列出 Instagram 私信会话

meta_get_instagram_messages

获取私信会话中的消息

meta_send_instagram_message

发送文本私信

meta_send_instagram_media_message

通过私信发送图片或链接

meta_get_instagram_available_catalogs

列出专业账户上可用于 Instagram Shopping 的产品目录

meta_get_instagram_broadcast_channels

列出广播频道

meta_get_broadcast_channel_messages

获取广播频道中的消息

meta_send_broadcast_channel_message

向广播频道发送消息

meta_create_broadcast_channel_poll

在广播频道中创建投票

Ads Manager — 62 个工具

工具

描述

meta_list_ad_accounts

列出您有权访问的广告账户

meta_get_ad_account

获取广告账户详情(状态、货币、花费上限、余额)

meta_list_campaigns

列出广告系列,支持状态筛选和分页

meta_get_campaign

获取单个广告系列的完整详情

meta_create_campaign

创建广告系列(支持针对 OUTCOME\_SALESAdvantage+ 购物)

meta_update_campaign

更新广告系列名称、状态、预算,或迁移到 Advantage+

meta_delete_campaign

删除广告系列

meta_migrate_campaign_to_advantage_plus

将广告系列迁移到 Advantage+ 购物(保留广告系列 ID)

meta_list_adsets

列出广告组,支持筛选

meta_get_adset

获取单个广告组的定向和预算详情

meta_create_adset

创建带有定向、预算和 placement\_soft\_opt\_out 的广告组

meta_update_adset

更新广告组的定向、预算或 placement\_soft\_opt\_out

meta_delete_adset

删除广告组

meta_list_ads

列出广告,支持状态筛选

meta_get_ad

获取单个广告的详情

meta_create_ad

创建广告,将创意关联到广告组

meta_update_ad

更新广告名称、状态或创意

meta_delete_ad

删除广告

meta_list_ad_creatives

列出广告创意

meta_get_ad_creative

获取单个创意的详情

meta_create_ad_creative

使用文本、图片和链接创建广告创意

meta_get_ad_preview

预览广告在不同版位中的展示效果

meta_get_ad_rule

获取特定自动化广告规则的详情

meta_get_ad_account_users

列出有权访问广告账户的用户

meta_upload_ad_image

上传图片以用于广告创意

meta_list_ad_images

列出之前上传的广告图片

meta_upload_ad_video

上传视频以用于广告创意

meta_list_ad_videos

列出之前上传的广告视频

meta_search_targeting_interests

搜索基于兴趣的定向选项

meta_search_targeting_geolocations

搜索基于位置的定向选项(国家/地区、城市、邮政编码)

meta_search_targeting_demographics

搜索人口统计定向选项

meta_browse_targeting_categories

浏览所有可用的定向类别

meta_get_reach_estimate

估算特定定向条件的潜在受众规模

meta_get_delivery_estimate

估算给定预算和定向下的广告投放效果

meta_search_leadgen_leads

获取线索广告表单提交的线索

meta_get_minimum_budgets

按货币和出价策略获取广告账户的最低每日预算和总预算

meta_list_leadgen_forms

列出 Facebook 主页的线索广告表单

meta_list_offline_event_sets

列出广告账户的线下转化事件组

meta_list_pixels

列出用于转化跟踪的 Meta Pixel

meta_create_pixel

创建新的 Pixel

meta_get_pixel

获取 Pixel 详情(名称、Cookie 状态、匹配字段)

meta_get_pixel_stats

获取一段时间内的事件量统计(验证 Pixel 是否正在触发)

meta_update_pixel

更新 Pixel 设置(名称、Cookie、匹配、数据使用)

meta_delete_pixel

删除 Pixel

meta_share_pixel

与另一个广告账户共享 Pixel 访问权限

meta_get_pixel_events

获取最近用于调试的测试事件

meta_list_custom_conversions

列出自定义转化事件

meta_create_custom_conversion

从 Pixel 事件创建自定义转化

meta_list_saved_audiences

列出已保存受众

meta_create_saved_audience

创建可复用的已保存受众

meta_delete_saved_audience

删除已保存受众

meta_list_ad_rules

列出自动化广告规则

meta_create_ad_rule

创建自动化规则(例如,暂停每次操作费用超过 $5 的广告)

meta_delete_ad_rule

删除自动化规则

meta_list_ad_labels

列出广告标签,用于整理和归组

meta_create_ad_label

创建广告标签

meta_get_ad_account_activity

获取广告账户的活动日志

meta_list_business_assets

列出 Business Manager 中的主页、广告账户、IG 账户和 Pixel

meta_create_ad_study

创建 A/B 测试,用于比较广告系列或广告组

meta_get_ad_studies

列出广告账户的所有 A/B 测试

meta_get_ad_study_results

获取 A/B 测试结果,包括胜者和置信度

meta_send_offline_event

发送线下转化事件,适用于门店购买、电话订单或其他线下转化

Threads — 22 个工具

完整的 Threads API — 支持 GIF、回复控制、位置标记和分析的发布功能。

工具

说明

threads_get_profile

获取你的 Threads 个人资料信息

threads_get_posts

获取你的近期帖子(支持分页)

threads_get_post

按 ID 获取单个帖子(包含 reply_audience)

threads_search

按关键词搜索你的帖子

threads_publish_text

发布文本帖子(支持回复控制和位置)

threads_publish_image

发布图片帖子(支持回复控制和位置)

threads_publish_video

发布视频帖子并自动轮询(支持回复控制和位置)

threads_publish_carousel

发布轮播帖(并行创建,支持回复控制)

threads_publish_link

发布带链接附件的帖子(支持回复控制)

threads_publish_gif

通过 GIPHY URL 发布 GIF 帖子

threads_delete_post

删除帖子

threads_get_replies

获取帖子的回复

threads_get_conversation

获取帖子的完整对话树

threads_get_followers

列出已认证 Threads 用户的粉丝

threads_get_following

列出已认证 Threads 用户关注的账户

threads_get_mentions

获取 @提及你的帖子

threads_get_media_children

获取轮播帖中的单个条目

threads_hide_reply

隐藏或重新显示回复

threads_repost

转发 Threads 帖子

threads_get_post_insights

获取特定帖子的指标(浏览数、点赞数、回复数等)

threads_get_user_insights

获取账户级指标及人口属性细分

threads_check_rate_limits

检查你当前的发布速率限制状态

Commerce — 10 个工具

用于 Facebook 和 Instagram 店铺的产品目录管理。

工具

说明

meta_list_product_catalogs

列出企业拥有的产品目录

meta_get_product_catalog

获取目录详情和产品数量

meta_list_products

列出目录中的产品(支持筛选)

meta_get_product

获取单个产品的完整详情

meta_create_product

向目录中添加产品

meta_create_product_feed

创建产品 Feed,从 URL 自动同步产品

meta_update_product

更新产品详情(名称、价格、库存状态等)

meta_delete_product

从目录中删除产品

meta_list_product_feeds

列出目录的产品 Feed

meta_list_product_sets

列出目录中的产品系列(子组)

Conversions API — 2 个工具

用于转化优化的服务端事件跟踪。

工具

说明

meta_send_conversion_event

向 Pixel 发送服务端转化事件(Purchase、Lead 等)

meta_test_conversion_events

测试 CAPI 配置,不影响生产数据

Audiences — 5 个工具

用于广告定向的自定义受众和类似受众管理。

工具

说明

meta_list_custom_audiences

列出广告账户中的自定义受众

meta_get_custom_audience

获取受众详情(受众规模、投放状态)

meta_create_custom_audience

创建自定义受众

meta_create_lookalike_audience

从来源受众创建类似受众

meta_delete_custom_audience

删除自定义受众

Insights — 4 个工具

从受众到广告层级的性能分析,提供 37 项指标、15 个日期预设和 8 个细分维度。

工具

说明

meta_get_account_insights

广告账户效果 — 花费、展示次数、触达人数、点击量、CTR、CPM、CPC、转化次数、ROAS、视频完播率、质量排名

meta_get_campaign_insights

广告系列效果,包含同样的全面指标

meta_get_adset_insights

广告组效果

meta_get_ad_insights

单个广告的效果

Charts — 2 个工具

从数据生成可视化图表,用于报告和演示。

工具

说明

meta_generate_chart

创建柱状图、折线图、饼图、环形图、雷达图,输出为 PNG 图片

meta_generate_comparison_chart

生成并排对比图(A/B 测试、周期对比)

广告库与实用工具 — 4 个工具

工具

说明

meta_search_ad_library

搜索任意广告主的当前投放广告 — 公开透明 API

meta_debug_token

检查你的令牌:类型、有效性、过期时间、权限、关联的应用和用户

meta_health_check

检查服务器健康:令牌状态、缓存令牌、API 连通性

meta_search_places

按名称或坐标搜索 Facebook 地点(位置)用于帖子标记


配置

变量

必需

默认值

说明

META_ACCESS_TOKEN

用于 Facebook 主页、Instagram、广告管理、商务、转化 API、受众、洞察及实用工具的长期有效 Meta 图表 API 令牌。

THREADS_ACCESS_TOKEN

Threads API 令牌。仅 Threads 发布、回复和洞察工具需要。

1. 创建 Meta 应用

前往 developers.facebook.comMy AppsCreate App → 选择 Business 类型。添加 Facebook LoginPages APIInstagram Graph APIMarketing API

2. 生成令牌

Graph API Explorer 获取一个令牌,然后将其换成长期有效令牌(60 天):

curl "https://graph.facebook.com/oauth/access_token?\
grant_type=fb_exchange_token&\
client_id=YOUR_APP_ID&\
client_secret=YOUR_APP_SECRET&\
fb_exchange_token=SHORT_LIVED_TOKEN"

如需永久访问,请在 Business Manager → System Users 中创建一个系统用户令牌。

Threads 使用单独的令牌,通过 graph.threads.net 的 OAuth 授权 — 请参阅 Threads API 文档

1Password 集成

如果环境中未设置 META_ACCESS_TOKENTHREADS_ACCESS_TOKEN,服务器会自动从 1Password CLI 尝试获取:

op://Development/Meta Access Token/credential
op://Development/Threads Access Token/credential

也就是说,只要你安装了 op,并且有活跃的服务账户或会话,就可以完全跳过设置环境变量。回退机制会让线程启动时间增加约 1-2 秒,若 1Password 不可用则自动跳过。

3. 授予权限

权限

用途

pages_show_list

列出主页

pages_read_engagement

主页互动,观点反应

pages_manage_posts

创建、编辑、删除帖子

pages_manage_metadata

主页设置、Webhooks、头像、封面照片

pages_read_user_content

标记的帖子、访客帖和评分

pages_messaging

阅读和发送消息,自动回复

instagram_basic

Instagram 账户信息

instagram_content_publish

发布照片、Reels、快拍和轮播帖

instagram_manage_insights

Instagram 分析数据

instagram_manage_comments

评论管理

instagram_manage_messages

Instagram 私信

ads_read

读取广告系列、广告组、广告、洞察数据

ads_management

创建和管理广告、A/B 测试

business_management

Business Manager 资产、产品目录

catalog_management

产品目录的增删改查

threads_basic

Threads 主页和帖子

threads_content_publish

在 Threads 发布内容

threads_manage_insights

Threads 数据分析

threads_manage_replies

管理 Threads 回复

4. 连接 MCP 客户端

Claude Code — 添加以下内容到 ~/.claude/settings.json

{
  "mcpServers": {
    "meta": {
      "command": "node",
      "args": ["/absolute/path/to/meta-mcp-server/dist/index.js"],
      "env": {
        "META_ACCESS_TOKEN": "your_long_lived_token",
        "THREADS_ACCESS_TOKEN": "your_threads_token"
      }
    }
  }
}

适用于任何支持 stdio 传输 的 MCP 客户端。THREADS_ACCESS_TOKEN 为可选 — 仅在使用 Threads 工具时需要。

工作原理

服务器可以在未配置任何令牌的情况下启动 — 不会崩溃,也不会在 MCP 设置中显示“失败”状态。当你没有正确认证而调用工具时,会得到清晰的状态信息。

首次调用应始终使用 meta_list_pages — 这会缓存所有 Page 和 Instagram 操作所需的页面级访问令牌。

错误处理

每条错误信息都会说明出错的缘由、原因以及如何修复:

问题场景

你会看到

未设置令牌

分步设置说明,附 Graph Explorer 链接

令牌已过期(错误码 190)

直达 developers.facebook.com 重新生成令牌的链接

缺少权限(错误码 10/200)

明确告知缺失的具体权限以及在哪里授予

请求频率受限(429)

提示你等待,并附上 Meta 的速率限制文档链接

缺少页面令牌

提醒你先调用 meta_list_pages

网络不可达

“无法访问 graph.facebook.com — 请检查你的网络连接”

令牌刷新

长期令牌的有效期为 60 天。使用 meta_debug_token 检查到期时间,然后刷新:

curl "https://graph.facebook.com/oauth/access_token?\
grant_type=fb_exchange_token&\
client_id=APP_ID&client_secret=APP_SECRET&\
fb_exchange_token=CURRENT_TOKEN"

如需永久令牌,请在 Business Manager → 系统用户中创建一个系统用户。


架构

src/
├── index.ts              Server entry point (stdio transport)
├── constants.ts          API versions, base URLs, field constants
├── types.ts              TypeScript interfaces for Meta entities
├── services/
│   ├── api.ts            MetaApiClient — dual Graph + Threads API
│   └── utils.ts          Error handling, formatting, shared schemas
└── tools/
    ├── pages.ts          52 Facebook Page tools
    ├── instagram.ts      37 Instagram tools
    ├── ads.ts            62 Ads Manager tools
    ├── threads.ts        22 Threads tools
    ├── commerce.ts       10 Commerce/Catalog tools
    ├── conversions.ts     2 Conversions API tools
    ├── audiences.ts       5 Audience tools
    ├── insights.ts        4 Insight tools
    ├── charts.ts          2 Chart generation tools
    ├── ad_library.ts      1 Ad Library tool
    └── utility.ts         3 Utility tools

关键设计决策

  • 双 API 客户端 — 同时处理 graph.facebook.com/v21.0graph.threads.net/v1.0,使用相互独立的 base URL 和令牌

  • 页面令牌缓存meta_list_pages 会缓存页面级令牌;后续工具按 page ID 查找令牌

  • 两步容器发布 — Instagram 和 Threads 采用容器 → 发布流程(container → publish);服务器通过轮询视频处理状态自动完成

  • 并行轮播处理 — 通过 Promise.allSettled 并发创建所有轮播项;当部分失败时,报告哪些轮播项已成功

  • Zod 严格模式 — 每个工具都使用严格的 Zod schema 对参数进行类型安全校验

  • 双输出格式 — 所有读取工具均支持 response_format: "markdown""json"

  • 优雅的鉴权 — 服务器没有配置令牌也能启动;首次调用工具时返回搭建指南,而不是直接崩溃

  • 图表生成 — 集成 QuickChart,将数据渲染为 PNG 图片用于生成报表


API 覆盖范围

面向 Meta Graph API v21.0Threads API v1.0

API

状态

Facebook Pages API

全面 — 帖子、评论、消息、成效分析、活动、媒体、Stories、Reels、Live Video、自动回复

Instagram Graph API

全面 — 发布、定时发布、评论、私信、广播频道、话题标签、企业发现、成效分析

Marketing API

全面 — 广告系列、广告组、广告、创意、定向、受众、Pixel、CAPI、A/B 测试、Advantage+

Threads API

全面 — 发布(文本、图片、视频、GIF、轮播图、链接)、回复设置、地点、成效分析

Commerce API

支持 — 商品目录 CRUD、商品系列

Conversions API

支持 — 服务端事件追踪,支持测试模式

Ad Library API

支持 — 公共透明度搜索

WhatsApp Business API

未覆盖 — 独立的基础设施和令牌流程


开发

本地开发和贡献检查使用相同的命令:

npm install
npm test            # 52 tests
npm run build       # TypeScript compilation
npm run test:watch  # Development mode

开发约定:读取工具使用 Zod .strict() 模式,并带上 response_format 参数;工具错误通过 errorResult() 返回,并标注 isError: true

新增连接器

新增连接器时应把与应用相关的代码与共享的 MCP 入口隔离:

  1. src/services/ 下新增一个 API 客户端,并基于环境变量配置凭据。

  2. src/tools/ 下新增一个或多个工具模块,使用严格的 Zod 输入 schema。

  3. src/index.ts 中注册这些工具。

  4. docs/ 和 README 中记录安装、权限以及支持的操作。

  5. 在提交 pull request 之前,添加单元测试和集成测试覆盖。

凭据统一放在环境变量或本地密钥管理器中。切勿将令牌、私钥或客户数据提交到代码仓库。

许可证

本项目采用该 MIT License 授权。可在个人或商业项目中免费使用,包括修改、托管和再分发,但需遵守许可证通知中的所有条款。第三方 API 和服务仍遵守其自身的条款、配额及身份验证要求。



Install Server
A
license - permissive license
B
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI assistants to manage Facebook and Instagram advertising via the Meta Marketing API. It provides comprehensive tools for campaign lifecycle management, performance analytics, audience targeting, and creative optimization.
    15
    194
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to manage Facebook and Instagram advertising data through the Meta Marketing API. It supports full campaign lifecycle management, performance analytics, audience targeting, and creative optimization.
    498
    MIT
  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI assistants to manage Facebook and Instagram advertising campaigns through the Meta Marketing API. Supports full campaign lifecycle management, performance analytics, audience targeting, and creative optimization.
  • A
    license
    B
    quality
    D
    maintenance
    Connects AI assistants to Meta's business platforms (Facebook, Instagram, Threads, Ads, Commerce) with 200 tools for publishing, engagement, analytics, ads, and commerce management.
    100
    214
    30
    MIT

View all related MCP servers

Related MCP Connectors

  • Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.

  • 60+ Meta Ads tools for AI agents: audits, campaign management, audiences and CAPI tracking.

  • Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/open-work-org/open-mcp-servers'

If you have feedback or need assistance with the MCP directory API, please join our Discord server