facebook-automata-mcp

公式Facebook Graph API用のMCP（Model Context Protocol）サーバー。Pages、Posts、Comments、Likes/Reactions、Photos/Videos、Events、Insightsのための完全なツールセットに加え、Facebook認証情報を保存・検証する専用ツールを提供します。

インストールと実行

uvがあればインストールは不要です：

uvx facebook-automata-mcp

またはpipでインストール：

pip install facebook-automata-mcp
facebook-automata-mcp

MCPクライアント（例：Claude Desktop / Claude Code）で使用する

{
  "mcpServers": {
    "facebook": {
      "command": "uvx",
      "args": ["facebook-automata-mcp"]
    }
  }
}

Related MCP server: Facebook MCP Server

認証情報

設定ファイルを手動で編集する必要はありません。サーバーがMCPクライアントに接続されたら、自分の言葉でFacebookを設定するよう依頼するだけで、set_facebook_credentialsツールが呼び出されます。例：

「FacebookアクセストークンをEAAB...に設定して」

これにより：

1. トークンをGET /meに対して検証します。

2. ~/.facebook-automata-mcp/credentials.jsonに保存します（0700/0600パーミッション、所有者のみ）。

3. 検証済みのID（id/name）を返します。

指定できるフィールド：

現在の認証情報は、いつでもcheck_facebook_credentials（ライブ検証呼び出し）またはget_credentials_status（オフライン、ファイルの存在のみ確認）で確認できます。削除するにはclear_facebook_credentialsを使用します。

認証情報は、保存されたファイルの代わりに（またはそれに加えて）環境変数でも提供できます — 環境変数が常に優先されます：

FACEBOOK_AUTOMATA_MCP_ACCESS_TOKEN=...
FACEBOOK_AUTOMATA_MCP_APP_ID=...
FACEBOOK_AUTOMATA_MCP_APP_SECRET=...
FACEBOOK_AUTOMATA_MCP_PAGE_ID=...
FACEBOOK_AUTOMATA_MCP_API_VERSION=v21.0
FACEBOOK_AUTOMATA_MCP_HOME=/custom/path   # overrides ~/.facebook-automata-mcp

トークンの取得

Pageの場合の最も簡単な方法は、MetaのGraph API Explorerです：アプリを選択し、pages_show_list、pages_read_engagement、pages_read_user_content、pages_manage_posts、pages_manage_engagementを含むUser Access Tokenを生成し、ここでget_my_accountsを呼び出してPage自身の（Pageスコープの）アクセストークンを取得し、それをPageレベルのツールのaccess_tokenとして使用します。

ツール

認証情報

• set_facebook_credentials — トークンの保存＋検証

• check_facebook_credentials — ライブ検証＋/debug_token情報

• get_credentials_status — オフライン確認

• clear_facebook_credentials — 保存された認証情報の削除

ID

• get_my_profile、get_user_profile、get_my_accounts

Pages

• search_pages、get_page_info、get_page_posts、get_page_feed、 get_page_tagged_posts、get_page_events、get_page_photos、 get_page_videos、get_page_albums、get_page_insights

Posts

• get_post、publish_page_post、delete_post

Comments

• get_post_comments（コメントした人を含む）、get_comment、 get_comment_replies、publish_comment、reply_to_comment、 delete_comment、hide_comment

Likes / Reactions

• get_post_likes、get_post_reactions（誰が＋どのリアクション）、 get_comment_likes、get_comment_reactions、like_object、 unlike_object

メディア

• upload_page_photo、upload_page_video

エスケープハッチ

• graph_api_get、graph_api_post、graph_api_delete — 上記でカバーされていない任意のGraph APIエッジを呼び出し

すべてのリスト形式のツールはlimitとafter（前回の呼び出しのnext_cursorからのページネーションカーソル）を受け付け、{ok, data, paging, next_cursor}を返します。

Facebook APIの制限に関する注意

• 最新のGraph APIバージョンでは、プライバシーポリシーにより、通常のユーザー向けのほとんどの個人プロフィールフィールドと従来の「誰がいいねしたか／友達リスト」データが制限されています — Page所有のコンテンツ（Pageの投稿、そのコメント、リアクション）が主なサポート対象のユースケースです。

• 一部の操作（投稿、削除、コメントの非表示、インサイト）には、関連するパーミッション（pages_manage_posts、pages_manage_engagement、read_insightsなど）を持つPageアクセストークンが必要で、公開アプリの場合はMeta App Reviewも必要です。

開発

python -m venv .venv && source .venv/bin/activate
pip install -e .
facebook-automata-mcp

PyPIへの公開

pip install build twine
python -m build
twine upload dist/*

公開後は、誰でもuvx facebook-automata-mcpで永続的なインストールなしに実行できます。

ライセンス

MIT