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/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

토큰 가져오기

페이지의 경우 가장 빠른 방법은 Meta의 Graph API Explorer입니다: 앱을 선택하고 pages_show_list, pages_read_engagement, pages_read_user_content, pages_manage_posts, pages_manage_engagement 권한으로 사용자 액세스 토큰을 생성한 다음, 여기서 get_my_accounts를 호출하여 페이지 자체(페이지 범위) 액세스 토큰을 가져와 페이지 수준 도구의 access_token으로 사용하세요.

도구

Credentials

• set_facebook_credentials — 토큰 저장 + 검증

• check_facebook_credentials — 실시간 검증 + /debug_token 정보

• get_credentials_status — 오프라인 확인

• clear_facebook_credentials — 저장된 자격 증명 삭제

Identity

• 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

Media

• upload_page_photo, upload_page_video

Escape hatch

• graph_api_get, graph_api_post, graph_api_delete — 위에서 다루지 않은 모든 Graph API 엣지 호출

모든 목록 스타일 도구는 limit과 after(이전 호출의 next_cursor에서 가져온 페이지네이션 커서)를 허용하며 {ok, data, paging, next_cursor}를 반환합니다.

Facebook API 제한 사항에 대한 참고 사항

• 최신 Graph API 버전은 개인정보 보호 정책으로 인해 일반 사용자의 대부분의 개인 프로필 필드와 기존의 "누가 좋아요를 눌렀는지 / 친구 목록" 데이터를 제한합니다 — 페이지 소유 콘텐츠(페이지 게시물, 해당 댓글 및 반응)가 기본 지원 사용 사례입니다.

• 일부 작업(게시, 삭제, 댓글 숨기기, 인사이트)에는 관련 권한(pages_manage_posts, pages_manage_engagement, read_insights 등)이 있는 페이지 액세스 토큰이 필요하며, 공개 앱의 경우 Meta 앱 검토(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