Facebook Page MCP Server

Facebook页面MCP服务器


该项目是一个模型上下文协议（MCP）服务器，作为Facebook Graph API的安全代理，允许人工智能模型和助手与特定的Facebook页面进行交互。

目录

• 概述
• 特性
• 入门指南
• 用法
• 连接到AI助手
• 部署
• 可用工具
• 贡献

概述

此服务器使用Node.js、Express和TypeScript构建，提供了一组可由任何兼容MCP的客户端调用的工具。它使用FacebookGraph API处理身份验证，并为常见的页面交互提供一个简单、安全的接口。

特性

• 安全：使用承载令牌身份验证保护您的MCP端点。
• 预定义工具：为Facebook页面管理提供了一套即用型工具。
• 灵活的：包括通用 graph-api-request 用于自定义API调用的工具。
• 轻松部署：只需单击一下即可部署到Vercel。
• 可扩展：轻松添加新工具和功能。

入门指南

先决条件

• Node.js（v18或更高版本）
• Facebook页面和相应的页面访问令牌。
• Vercel命令行界面 （可选，用于CLI部署）。

安装和配置

1. 克隆存储库：

   git clone https://github.com/RadouaneElarfaoui/facebook-page-mcp-server.git
   cd facebook-page-mcp-server

1. 安装依赖项：

   npm install

1. 设置环境变量：

复制示例文件：

   cp .env.example .env

编辑 .env 使用您的凭据文件：

- FB_PAGE_ACCESS_TOKEN：您的Facebook页面访问令牌。 - MCP_ACCESS_TOKEN：用于保护服务器的秘密密码。

用法

运行服务器

• 发展模式 （热重新加载）：

  npm run dev

• 生产模式:

  npm run build
  npm start

默认情况下，服务器将在端口3000上运行。

提出请求

发送a POST 请求 /mcp 端点与您的 MCP_ACCESS_TOKEN 作为不记名代币。

示例 curl 请求：

curl -X POST http://localhost:3000/mcp \
     -H "Authorization: Bearer YOUR_SECRET_MCP_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "tool": "get-page-info",
           "parameters": {}
         }'

连接到AI助手

您可以将此服务器连接到任何兼容MCP的AI助手。

VS代码（副本）

1. 在本地启动服务器.

1. 在您的VS代码设置中(mcp.json)，定义MCP服务器：

   "mcpServers": {
       "facebook-page": {
           "url": "http://localhost:3000/mcp",
           "headers": {
               "Authorization": "Bearer YOUR_SECRET_MCP_ACCESS_TOKEN"
           }
       }
   }

备注：对于已部署的服务器，请将本地URL替换为生产URL。

拟人克劳德桌面

1. 在本地启动服务器.

1. 找到您的Claude Desktop配置文件：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json

1. 编辑文件 要添加服务器终结点，请执行以下操作：

   {
     "mcpHttpEndpoints": [
       {
         "url": "http://localhost:3000/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_SECRET_MCP_ACCESS_TOKEN"
         }
       }
     ]
   }

记得更换 YOUR_SECRET_MCP_ACCESS_TOKEN 用你的代币 .env 文件。

部署

维塞尔

方法1:Vercel网站（推荐）

1. 单击此README顶部的“使用Vercel部署”按钮。
2. 按照屏幕上的说明，创建一个新的Git存储库。
3. 在Vercel项目设置中，添加您的 FB_PAGE_ACCESS_TOKEN 和 MCP_ACCESS_TOKEN 作为环境变量。

方法2:Vercel CLI

1. 安装Vercel命令行界面 (npm i -g vercel)并登录(vercel login).
2. 链接项目 (vercel link).
3. 添加机密：

   vercel secret add fb-page-access-token YOUR_FB_PAGE_ACCESS_TOKEN
   vercel secret add mcp-access-token YOUR_MCP_ACCESS_TOKEN

1. 部署到生产环境：

   vercel --prod

可用工具

• get-page-info：获取基本页面详细信息。
• get-page-feed：从页面的订阅源获取最新帖子。
• create-post：创建新帖子。
• update-post：更新现有帖子。
• delete-post：删除帖子。
• graph-api-request：向Graph API发出通用请求。

贡献

欢迎投稿！请打开一个问题来讨论您的想法或提交一个pull请求。

1. 分叉存储库。
2. 创建功能分支(git checkout -b feature/YourFeature).
3. 提交您的更改(git commit -m 'Add YourFeature').
4. 推到分支(git push origin feature/YourFeature).
5. 打开拉取请求。