原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。评价和账户功能将在后续阶段推出。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

Facebook MCP

作者:IvanBBaev版本 0.8.0i★ –i在你的电脑上运行
注册名称io.github.IvanBBaev/facebook-mcp

安装

概览

作者提供的说明(英文原文)

Facebook Pages MCP server for the Meta Graph API — publishing, insights, moderation, messaging

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

  • 连接方式: 在你的电脑上运行
  • 传输方式: stdio
  • 分类: 营销与社交媒体
  • 你需要填写:FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN, FB_PAGE_TOKEN, FB_APP_SECRET, FB_CONFIRM_TOKEN, FB_HTTP_TOKEN

安装

选择你使用的 AI 应用,然后复制设置。

安装之前

  • 基础检查:1 项中通过 1 项
  • 在你的电脑上运行,拥有你的用户账户的权限(文件、网络、应用)。
  • 需要你自己填写: FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN, FB_PAGE_TOKEN, FB_APP_ID, FB_APP_SECRET, FB_PAGE_ID, FB_API_VERSION, FB_ADS_API_VERSION, FB_REQUEST_TIMEOUT_MS, FB_HOST_CONCURRENCY, FB_MAX_RESULT_CHARS, FB_WRITE_MODE, FB_CONFIRM_TOKEN, FB_MEDIA_DIR, FB_JOURNAL_PATH, FB_ACTIVITY_STATE_PATH, FB_EXPORT_DIR, FB_TOOL_PACKAGES, FB_PACKAGES_DENY, FB_PACKAGES_READONLY, FB_TRANSPORT, FB_HTTP_TOKEN, FB_HTTP_PORT, FB_AD_ACCOUNT_ID, FB_ADS_BUDGET_CEILING, FB_ADS_CAMPAIGN_SPEND_CAP_MAX, FB_LOG_LEVEL

标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。

你需要

  • npm已安装 Node.js(用于 npx 命令)

你用的是哪个应用?

在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "facebook": {
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "your-value",
        "FB_ACCESS_TOKEN": "your-value",
        "FB_PAGE_TOKEN": "your-value",
        "FB_APP_ID": "your-value",
        "FB_APP_SECRET": "your-value",
        "FB_PAGE_ID": "your-value",
        "FB_API_VERSION": "your-value",
        "FB_ADS_API_VERSION": "your-value",
        "FB_REQUEST_TIMEOUT_MS": "your-value",
        "FB_HOST_CONCURRENCY": "your-value",
        "FB_MAX_RESULT_CHARS": "your-value",
        "FB_WRITE_MODE": "your-value",
        "FB_CONFIRM_TOKEN": "your-value",
        "FB_MEDIA_DIR": "your-value",
        "FB_JOURNAL_PATH": "your-value",
        "FB_ACTIVITY_STATE_PATH": "your-value",
        "FB_EXPORT_DIR": "your-value",
        "FB_TOOL_PACKAGES": "your-value",
        "FB_PACKAGES_DENY": "your-value",
        "FB_PACKAGES_READONLY": "your-value",
        "FB_TRANSPORT": "your-value",
        "FB_HTTP_TOKEN": "your-value",
        "FB_HTTP_PORT": "your-value",
        "FB_AD_ACCOUNT_ID": "your-value",
        "FB_ADS_BUDGET_CEILING": "your-value",
        "FB_ADS_CAMPAIGN_SPEND_CAP_MAX": "your-value",
        "FB_LOG_LEVEL": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add facebook --env FB_SYSTEM_TOKEN=your-value --env FB_ACCESS_TOKEN=your-value --env FB_PAGE_TOKEN=your-value --env FB_APP_ID=your-value --env FB_APP_SECRET=your-value --env FB_PAGE_ID=your-value --env FB_API_VERSION=your-value --env FB_ADS_API_VERSION=your-value --env FB_REQUEST_TIMEOUT_MS=your-value --env FB_HOST_CONCURRENCY=your-value --env FB_MAX_RESULT_CHARS=your-value --env FB_WRITE_MODE=your-value --env FB_CONFIRM_TOKEN=your-value --env FB_MEDIA_DIR=your-value --env FB_JOURNAL_PATH=your-value --env FB_ACTIVITY_STATE_PATH=your-value --env FB_EXPORT_DIR=your-value --env FB_TOOL_PACKAGES=your-value --env FB_PACKAGES_DENY=your-value --env FB_PACKAGES_READONLY=your-value --env FB_TRANSPORT=your-value --env FB_HTTP_TOKEN=your-value --env FB_HTTP_PORT=your-value --env FB_AD_ACCOUNT_ID=your-value --env FB_ADS_BUDGET_CEILING=your-value --env FB_ADS_CAMPAIGN_SPEND_CAP_MAX=your-value --env FB_LOG_LEVEL=your-value -- npx -y @ivanbaev/facebook-mcp

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "facebook": {
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "your-value",
        "FB_ACCESS_TOKEN": "your-value",
        "FB_PAGE_TOKEN": "your-value",
        "FB_APP_ID": "your-value",
        "FB_APP_SECRET": "your-value",
        "FB_PAGE_ID": "your-value",
        "FB_API_VERSION": "your-value",
        "FB_ADS_API_VERSION": "your-value",
        "FB_REQUEST_TIMEOUT_MS": "your-value",
        "FB_HOST_CONCURRENCY": "your-value",
        "FB_MAX_RESULT_CHARS": "your-value",
        "FB_WRITE_MODE": "your-value",
        "FB_CONFIRM_TOKEN": "your-value",
        "FB_MEDIA_DIR": "your-value",
        "FB_JOURNAL_PATH": "your-value",
        "FB_ACTIVITY_STATE_PATH": "your-value",
        "FB_EXPORT_DIR": "your-value",
        "FB_TOOL_PACKAGES": "your-value",
        "FB_PACKAGES_DENY": "your-value",
        "FB_PACKAGES_READONLY": "your-value",
        "FB_TRANSPORT": "your-value",
        "FB_HTTP_TOKEN": "your-value",
        "FB_HTTP_PORT": "your-value",
        "FB_AD_ACCOUNT_ID": "your-value",
        "FB_ADS_BUDGET_CEILING": "your-value",
        "FB_ADS_CAMPAIGN_SPEND_CAP_MAX": "your-value",
        "FB_LOG_LEVEL": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "facebook": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "your-value",
        "FB_ACCESS_TOKEN": "your-value",
        "FB_PAGE_TOKEN": "your-value",
        "FB_APP_ID": "your-value",
        "FB_APP_SECRET": "your-value",
        "FB_PAGE_ID": "your-value",
        "FB_API_VERSION": "your-value",
        "FB_ADS_API_VERSION": "your-value",
        "FB_REQUEST_TIMEOUT_MS": "your-value",
        "FB_HOST_CONCURRENCY": "your-value",
        "FB_MAX_RESULT_CHARS": "your-value",
        "FB_WRITE_MODE": "your-value",
        "FB_CONFIRM_TOKEN": "your-value",
        "FB_MEDIA_DIR": "your-value",
        "FB_JOURNAL_PATH": "your-value",
        "FB_ACTIVITY_STATE_PATH": "your-value",
        "FB_EXPORT_DIR": "your-value",
        "FB_TOOL_PACKAGES": "your-value",
        "FB_PACKAGES_DENY": "your-value",
        "FB_PACKAGES_READONLY": "your-value",
        "FB_TRANSPORT": "your-value",
        "FB_HTTP_TOKEN": "your-value",
        "FB_HTTP_PORT": "your-value",
        "FB_AD_ACCOUNT_ID": "your-value",
        "FB_ADS_BUDGET_CEILING": "your-value",
        "FB_ADS_CAMPAIGN_SPEND_CAP_MAX": "your-value",
        "FB_LOG_LEVEL": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

这个服务器在你的电脑上运行,而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上,无需账户。

需要你填写的值

  • FB_SYSTEM_TOKEN 机密 env
    System-user access token (Business Manager). Takes precedence over FB_ACCESS_TOKEN and FB_PAGE_TOKEN when several are set.
  • FB_ACCESS_TOKEN 机密 env
    Primary user access token. At least one of FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN or FB_PAGE_TOKEN must be set.
  • FB_PAGE_TOKEN 机密 env
    Long-lived Page access token used as a fallback credential when no user or system-user token is configured. It belongs to exactly one Page, so set FB_PAGE_ID to that Page ID alongside it (the doctor…
  • FB_APP_ID env
    Meta app ID; combined with FB_APP_SECRET it forms the app access token used to authorize /debug_token inspection.
  • FB_APP_SECRET 机密 env
    Meta app secret. When set, appsecret_proof is attached to every call so a stolen bare token cannot be used on its own.
  • FB_PAGE_ID env
    Default Facebook Page ID, used when a tool call omits an explicit profile argument. Required when FB_PAGE_TOKEN is the only credential: it names the Page that token belongs to.
  • FB_API_VERSION env
    Graph API version to target. Defaults to the tested pinned version; other values are accepted verbatim as an escape hatch but are not tested.
  • FB_ADS_API_VERSION env
    Marketing API version the ads tools target (ad accounts, campaigns, ad sets, ads, insights, async reports). The Marketing API retires versions on its own, shorter schedule, so it is pinned separately…
  • FB_REQUEST_TIMEOUT_MS env
    Per-request timeout in milliseconds; integer in [1, 600000].
  • FB_HOST_CONCURRENCY env
    Maximum number of in-flight requests per Graph host; integer in [1, 64].
  • FB_MAX_RESULT_CHARS env
    Character budget applied by the result shaper before a tool result is truncated; integer in [500, 10000000].
  • FB_WRITE_MODE env
    Write gating mode: plan (validating dry-run preview, the default) or apply. It never covers the irreversible and spend tiers, which always need a per-call apply plus a plan_id.
  • FB_CONFIRM_TOKEN 机密 env
    Operator confirmation token for out-of-band approval of irreversible or spend actions. The server prompts through MCP elicitation where the client supports it; otherwise the caller passes this value…
  • FB_MEDIA_DIR env
    Directory permitted for local media uploads. Unset means URL-only uploads and no local file access at all.
  • FB_JOURNAL_PATH env
    Path to the append-only write journal. Defaults to the XDG/%APPDATA% state path; the file is created owner-only (0600) and rotates by size.
  • FB_ACTIVITY_STATE_PATH env
    Path to the small JSON file where facebook_get_activity_since keeps, per Page, the horizon of the last complete read. Defaults to the XDG/%APPDATA% state path next to the journal; the file holds Page…
  • FB_EXPORT_DIR env
    Directory where the insights tools write a CSV or JSON file when called with `output`. Defaults to `exports/` under the XDG/%APPDATA% state path. Files are written atomically and owner-only (0600) an…
  • FB_TOOL_PACKAGES env
    Comma-separated tool packages or profiles to expose (e.g. core,posts,reader, or the profiles core|all|reader|publisher|moderator|ads). Omit for the default profile, which excludes ads.
  • FB_PACKAGES_DENY env
    Comma-separated packages OR profiles to exclude even when FB_TOOL_PACKAGES enables them; deny wins over allow. Profile names expand here exactly as they do in FB_TOOL_PACKAGES, and a profile beats a…
  • FB_PACKAGES_READONLY env
    Comma-separated packages OR profiles whose write tools are not registered at all; the read tools of those packages stay available. Profile names expand as they do in FB_TOOL_PACKAGES, so FB_PACKAGES_…
  • FB_TRANSPORT env
    Transport protocol: stdio (default) or http. The http transport binds 127.0.0.1 only and fails closed without FB_HTTP_TOKEN.
  • FB_HTTP_TOKEN 机密 env
    Bearer token guarding the HTTP transport; required when FB_TRANSPORT=http (the server refuses to start without it). At least 16 characters — a shorter value is refused (under stdio it is dropped with…
  • FB_HTTP_PORT env
    Port for the HTTP transport (loopback only); used when FB_TRANSPORT=http. Integer in [1, 65535].
  • FB_AD_ACCOUNT_ID env
    Default ad account ID (act_… or the bare numeric id) for the opt-in ads package.
  • FB_ADS_BUDGET_CEILING env
    Hard ceiling for any ads budget write, in minor units of the ad account's own currency (e.g. cents for USD). Non-negative integer; a write above it is refused. No currency conversion: size it for the…
  • FB_ADS_CAMPAIGN_SPEND_CAP_MAX env
    Largest campaign spend_cap (the lifetime total a campaign may spend) that an ads write may set, in minor units of the ad account's own currency. Non-negative integer; a cap above it is refused, never…
  • FB_LOG_LEVEL env
    Stderr log verbosity: debug, info, warn or error. Logs never go to stdout — that is the stdio protocol channel.

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

它能做什么

它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月6日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 IvanBBaev 验证,该账户拥有此仓库

  • … 尚未检查

    仍在维护

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • – 不适用

    端点有响应

    它在你的电脑上运行,没有互联网端点

  • – 不适用

    使用 OAuth 登录

    在你的电脑上运行,改用本地设置

  • … 尚未检查

    工具描述中没有隐藏指令

    它在你的电脑上运行;我们只能读取互联网端点的工具列表

与“营销与社交媒体”中的其他服务器比较i

  • 星标数多于此分类中其他 2969 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 2969 个服务器的 79% 更新
  • 基础检查结果等于或优于此分类中其他 2969 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

Facebook MCP 安全吗?

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

你需要填写:FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN, FB_PAGE_TOKEN, FB_APP_SECRET, FB_CONFIRM_TOKEN, FB_HTTP_TOKEN

它在我的电脑上运行还是在云端?

它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。

它还在维护吗?

GitHub 仓库最后更新于–,最新版本(0.8.0)于9天前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。

有什么可以替代它?

同一分类中有:MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

MCP YouTube Transcript

作者:jkawamoto

An MCP server retrieving transcripts of YouTube videos

在你的电脑上运行★ 495MIT9天前更新
安装

Google Analytics MCP

作者:surendranb

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

在你的电脑上运行★ 244MIT9天前更新
安装

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

在云端运行★ 137MIT10天前更新
安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

facebook-mcp — an MCP server for Facebook Pages

📖 [Documentation site →](https://ivanbbaev.github.io/facebook-mcp/)

A local-first, MIT-licensed TypeScript Model Context Protocol (MCP) server for developers who run their own Facebook Page(s) from an MCP client such as Claude Code, Claude Desktop, VS Code or Cursor. It talks to the Meta Graph API through your own Meta developer app and your own token: publishing, reading and insights, comment moderation and Messenger replies. Writes return a preview first by default (plan-and-apply), and the server sends no telemetry.

Things you could ask your agent once it is set up (the tools exist; see Status for what has been verified):

  • _"Draft a post with this photo and schedule it for Friday 9:00 — show me the preview first."_
  • _"Triage the unanswered comments on last week's posts."_
  • _"Give me this week's Page report."_

Not for you if you do not want to create a Meta developer app and handle an App ID, an App Secret and a token yourself — hosted social-media connectors with a one-click login are a better fit for that. It is also not for personal profiles, Groups, Instagram (there is a sibling server) or a hosted service for other people's Pages — see Not in scope.

Status

🚧 Pre-1.0, and not yet verified against a live Page. The latest release is

@ivanbaev/facebook-mcp

0.8.0 on npm. This README describes main, which can be ahead of that release;

unreleased changes are listed in changes/unreleased/.

  • Implemented, not live-verified. All 69 tools in the tool table are implemented. Every test in this repository runs against fakes and recorded fixtures behind a network fence that throws on a real fetch, so "the tests pass" means "the code does what the fixtures say", not "Meta accepted it". A live smoke harness exists (scripts/smoke/) but has not been run against a real Page for any release.
  • No client verified by hand. CI starts the packed server with npx on Linux, macOS and Windows, but no person has walked an install end-to-end in any MCP client yet — see Client compatibility.
  • Experimental tools. Some tools are marked experimental (list under Not in scope): they may change in any minor release, even after 1.0.
  • Breaking changes are planned. 0.9 changes tool contracts (see Roadmap). Read Known limitations before you rely on anything.

Contents: Status · Features · Requirements · Setup · Client compatibility · Configure credentials · Permissions · Tools · How this compares · Known limitations · Not in scope · Your responsibilities · Roadmap · Security notes · Documentation · Support · Trademark · License

Features

Implementation status only — see Status for what "implemented" does and does not mean. "Experimental" follows the experimental tier.

AreaCapabilityStatus
Core & diagnosticsIdentity, Page listing, rate-limit usage, doctor pre-flight check, setup-token✅ Implemented, not live-verified
ReadingPage and post reads, Reels, reactions, Stories, albums and photos, cursor pagination✅ Implemented, not live-verified
PublishingText / link / photo / video / Reels posts, Stories, scheduling, edit and delete✅ Implemented, not live-verified
InsightsPage, post and Reel insights, a one-call Page report, a posts comparison table, metric-rename and retirement guidance✅ Implemented, not live-verified
ModerationComment reads and triage, replies, comment edits, hide, like, delete, private reply, block/unblock, moderation settings✅ Implemented, not live-verified
MessagingConversation reads, "what is new since", replies within the 24-hour window, saved replies; message reactions, attachments and labels✅ Implemented, not live-verified (some experimental)
Ads (opt-in)Campaign / ad-set / ad reads, previews, insights, status, budget and spend-cap control; archive/delete, image upload, targeting edits, copies, boost✅ Implemented, not live-verified (some experimental)
Page profile (opt-in)Edit the Page's about, description, website, phone, hours, temporary status✅ Implemented, not live-verified, experimental
Live verificationEvery tool exercised against a real Page and a real ad account❌ Not done — see Status
npm / MCPB releasenpx @ivanbaev/facebook-mcp, attested .mcpb bundle, MCP Registry listing✅ Published — 0.8.0

Each tool wraps one capability rather than mirroring every Graph edge. Six packages (53 tools) are on by default; ads and page_admin are opt-in.

  • Local-first, no telemetry. Only three Meta hosts are ever reached (graph, graph-video, rupload); nothing phones home.
  • Least-privilege credentials. Works with a never-expiring System User token (Business Manager) or a long-lived Page token — no App Review required for an admin operating their own assets.
  • Safe writes. Tiered plan-and-apply gating; irreversible and spend actions require out-of-band confirmation and are never unlocked by an env flag alone.
  • Secret hygiene. Value-based redaction of secrets at a single choke-point across logs, errors, tool results, and the write journal.
  • Layered architecture. Lint-enforced core ← api ← mcp ← tools ← cli ← server layering, tools-as-data with a central package registry.

Requirements

  • Node.js ≥ 22 (enforced by engines and a runtime guard in the launcher; the project targets the version in .nvmrc).
  • A Meta (Facebook) developer app — a Business-type app at Standard Access is enough; no App Review is needed to operate your own assets.
  • A Facebook Page (and, for the opt-in ads package, an ad account) you administer.

Setup

The first run is five steps, in this order. Most of the time goes into Meta's app UI. docs/runbooks/onboarding.md is the long form with troubleshooting.

  1. Meta app — create a Business-type app at https://developers.facebook.com/apps and note its App ID and App Secret (Settings → Basic). setup-token needs both.
  2. Short-lived token — in the Graph API Explorer pick your app, User Token, tick the scopes you need (at least pages_show_list and pages_read_engagement), and Generate Access Token. It lives 1–2 hours, so do step 3 right away.
  3. Exchange it and write the env file — setup-token swaps it for a ~60-day token, resolves your Page and writes the env file:
   FB_APP_ID='<app id>' FB_APP_SECRET='<app secret>' \

FB_SETUP_TOKEN=' ' \ npx -y @ivanbaev/facebook-mcp setup-token

Success is status: completed in the Run block and status: written in the Env file block. The file lands at ~/.config/facebook-mcp/.env ($XDG_CONFIG_HOME if set) or %APPDATA%\facebook-mcp\.env on Windows, mode 0600. The server reads it on every start, so the client config below needs no env block. More than one Page? Re-run with --page= --force.

  1. Pre-flight — every package you plan to use should be usable:
   npx -y @ivanbaev/facebook-mcp doctor
  1. Register the server with your client and make the first call — see the next two subsections, then

只显示了开头部分;其余内容请在仓库中阅读

问 PopNx