AI导哈

Facebook页面MCP服务器

一个安全的Facebook Graph API代理服务器，允许AI模型和助手与特定Facebook页面进行交互。

  • by RadouaneElarfaoui
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 radouaneelarfaoui/facebook-page-mcp-server

使用说明

Facebook页面MCP服务器

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

目录

概述

此服务器使用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

  2. 安装依赖项：

    npm install

  3. 设置环境变量： 复制示例文件：

    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. 在本地启动服务器.

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

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

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

拟人克劳德桌面

  1. 在本地启动服务器.

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

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

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

    {
  "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
  4. 部署到生产环境：
    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. 打开拉取请求。

相关 MCP