快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

Meta Graph API MCP服务器

用于Meta Graph API的模型上下文协议（MCP）服务器-Facebook页面、Instagram业务、内容管理和分析。

特性

Facebook页面：列出页面，创建/管理帖子，适度评论
Instagram商业：管理连接的Instagram帐户，创建帖子，查看见解
分析：页面洞察、帖子参与度指标、Instagram统计数据
媒体上传：将照片上传到Facebook和Instagram
OAuth 2.0：自动代币交换和长期代币管理

快速开始

1.创建元开发者应用程序

首选面向开发人员的Meta
点击 创建应用程序 并选择商业应用程序类型
添加 脸书登录 产品
配置OAuth重定向类型： http://localhost:3000/oauth/callback
注意你的 应用程序ID 和 应用程序密钥

2.配置权限

在应用程序的应用程序审查部分，请求这些权限（所有权限都可以通过标准访问获得）：

页：

pages_show_list -列出托管页面
pages_read_engagement -阅读帖子、关注者、元数据
pages_manage_posts -创建/编辑/删除帖子
pages_read_user_content -阅读页面上的用户评论
pages_manage_engagement -回复/删除评论
read_insights -页面和帖子分析

Instagram：

instagram_basic -阅读Instagram个人资料和媒体
instagram_content_publish -创建有机帖子
instagram_manage_comments -管理评论
instagram_manage_insights -获取Instagram见解

3.安装和配置

# Clone the repository
git clone https://github.com/jordanburke/meta-graph-api-mcp-server.git
cd meta-graph-api-mcp-server

# Install dependencies
pnpm install

# Copy environment template
cp .env.example .env

# Edit .env with your credentials

4.环境变量

# Required
FACEBOOK_APP_ID=your_app_id
FACEBOOK_APP_SECRET=your_app_secret

# Server Configuration
TRANSPORT_TYPE=http    # "http" for web/remote, "stdio" for Claude Desktop
PORT=3000
HOST=localhost
BASE_URL=http://localhost:3000

5.运行服务器

# Development (hot reload)
pnpm serve:dev

# Production
pnpm start

MCP工具（共20个）

连接和页面

工具	说明
`test_connection`	测试服务器连接
`get_my_pages`	列出所有管理的Facebook页面
`get_page`	获取详细的页面信息

帖子

工具	说明
`create_page_post`	创建帖子（文本、链接或带照片）
`get_page_posts`	列出页面中的最新帖子
`get_post`	获得一个有参与度的帖子
`delete_post`	删除帖子

媒体

工具	说明
`upload_photo`	通过URL上传照片

分析

工具	说明
`get_page_insights`	页面级分析（印象、参与度、粉丝）
`get_post_insights`	参与后指标

Instagram商业

工具	说明
`get_instagram_account`	获取Instagram商业账号链接
`get_instagram_media`	列出Instagram帖子
`create_instagram_post`	创建Instagram帖子（图片+标题）
`get_instagram_comments`	在Instagram媒体上列出评论
`reply_to_instagram_comment`	回复Instagram评论
`get_instagram_insights`	Instagram帐户分析

克劳德桌面/Claude代码配置

选项1:npx（推荐）

无需安装-直接从npm运行：

克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "meta-graph-api": {
      "command": "npx",
      "args": ["-y", "meta-graph-api-mcp-server"],
      "env": {
        "FACEBOOK_APP_ID": "your_app_id",
        "FACEBOOK_APP_SECRET": "your_app_secret",
        "TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

克劳德代码 (.mcp.json 在您的项目中）：

{
  "mcpServers": {
    "meta-graph": {
      "command": "npx",
      "args": ["-y", "meta-graph-api-mcp-server"],
      "env": {
        "FACEBOOK_APP_ID": "your_app_id",
        "FACEBOOK_APP_SECRET": "your_app_secret",
        "TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

选项2:HTTP模式（用于开发）

单独运行服务器并通过HTTP连接。在开发或调试时很有用：

启动服务器：

FACEBOOK_APP_ID=xxx FACEBOOK_APP_SECRET=yyy pnpm serve:dev

配置MCP以连接：

{
  "mcpServers": {
    "meta-graph": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

选项3：本地安装

如果您更喜欢本地安装：

{
  "mcpServers": {
    "meta-graph-api": {
      "command": "node",
      "args": ["/path/to/meta-graph-api-mcp-server/dist/bin.cjs"],
      "env": {
        "FACEBOOK_APP_ID": "your_app_id",
        "FACEBOOK_APP_SECRET": "your_app_secret",
        "TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

身份验证流程

服务器实现了完整的OAuth 2.0流程：

授权：用户访问 /oauth/authorize 并通过Facebook进行身份验证
代码交换：服务器为短期令牌交换授权码
令牌扩展：短期代币兑换长期代币（60天）
页面令牌：服务器通过以下方式获取页面访问令牌 /me/accounts
会话管理：FastMCP发行映射到Facebook代币的JWT

开发命令

# Pre-checkin (format, lint, test, build)
pnpm validate

# Individual commands
pnpm format        # Format code
pnpm lint          # Fix lint issues
pnpm test          # Run tests
pnpm build         # Production build
pnpm dev           # Watch mode

# Server
pnpm start         # Build and run
pnpm serve         # Run built server
pnpm serve:dev     # Hot reload development
pnpm inspect       # MCP inspector for debugging

项目结构

src/
├── index.ts                    # MCP server with OAuth proxy
├── bin.ts                      # CLI entry point
├── types.ts                    # Type definitions
├── client/
│   └── meta-graph-client.ts    # Meta Graph API client
└── utils/
    └── formatters.ts           # Markdown formatters
test/
└── formatters.spec.ts          # Formatter tests

API 参考

图形API版本

服务器使用Meta Graph API v21.0.

速率限制

标准访问：因端点而异
页面洞察：每小时200个电话
帖子创建：基于应用层

错误处理

所有错误都会返回描述性消息：

Meta API Error [190]: Invalid OAuth access token
Meta API Error [100]: (#100) Pages Public Content Access requires...

故障排除

“OAuth访问令牌无效”

令牌可能已过期（长期令牌持续60天）
通过OAuth流重新进行身份验证

“页面公共内容访问需要…”

您的应用需要app Review才能访问公共页面
对于测试，将自己添加为应用程序上的测试人员/管理员

未找到Instagram帐户

确保Facebook页面有一个连接的Instagram商业帐户
Instagram必须是商业或创作者帐户（非个人帐户）

许可证

麻省理工学院

目录标签

社交媒体管理数据分析TypeScriptClaude知识管理本地部署内容管理OAuth2.0MetaGraphAPI

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

未说明

鉴权方式（authType，认证方式）

oauth

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

未说明oauth部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

仍需确认：installCommand

来源信息

MCP World

mcpworld.com

/detail/00d4579f6e1923999cb8c2984d73ddc6

一个用于Meta Graph API的模型上下文协议（MCP）服务器，支持Facebook页面、Instagram商业账户的内容管理和分析。

继续浏览同类 MCP

更多文档知识 MCP（3,282）返回 MCP 目录

上一个 MCP

Mermaid MCP 812f8336

一个简单的MCP服务器，使用mermaid-cli和FastMCP将Mermaid图表渲染为SVG/PNG/PDF格式。

下一个 MCP

Mgesteban MCP

全面解析MCP Server StarterMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，MCP Server Starter能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

工具	说明
`get_post_comments`	列出帖子的评论
`reply_to_comment`	对评论的回复
`delete_comment`	删除评论

Meta Graph API MCP Server