페이스북-mcp-서버

페이스북 MCP 서버

이 프로젝트는 Facebook Graph API를 사용하여 Facebook 페이지의 상호작용을 자동화하고 관리하는 MCP 서버 입니다. 게시물 작성, 댓글 관리, 게시물 분석 결과 가져오기, 부정적인 피드백 필터링 등의 도구를 제공하며, Claude 또는 다른 LLM 기반 에이전트와 연동하여 사용할 수 있습니다.

🤖 이게 뭐예요?

이 MCP는 Facebook 페이지에 직접 연결되는 AI 호출 도구 모음을 제공하며, 일반적인 API 작업을 LLM 친화적인 함수로 추상화합니다.

✅ 혜택

소셜 미디어 관리자가 검토 및 분석을 자동화할 수 있도록 지원합니다.
Claude Desktop이나 모든 Agent 클라이언트 와 완벽하게 통합됩니다.
자연어를 통해 Facebook 콘텐츠를 세부적으로 제어할 수 있습니다.

📦 특징

도구	설명
`post_to_facebook`	메시지가 포함된 새로운 Facebook 게시물을 작성하세요.
`reply_to_comment`	게시물의 특정 댓글에 답변합니다.
`get_page_posts`	페이지에서 최근 게시물을 검색합니다.
`get_post_comments`	주어진 게시물에 대한 댓글을 가져옵니다.
`delete_post`	ID로 특정 게시물을 삭제합니다.
`delete_comment`	ID로 특정 댓글을 삭제합니다.
`delete_comment_from_post`	특정 게시물에서 댓글을 삭제하는 별칭입니다.
`filter_negative_comments`	부정적인 감정 키워드가 포함된 댓글을 걸러냅니다.
`get_number_of_comments`	게시물에 달린 댓글의 수를 세어보세요.
`get_number_of_likes`	게시물의 좋아요 수를 세어보세요.
`get_post_impressions`	게시물의 총 노출수를 확인하세요.
`get_post_impressions_unique`	게시물을 본 고유 사용자 수를 가져옵니다.
`get_post_impressions_paid`	게시물에 대한 유료 노출 수를 확인하세요.
`get_post_impressions_organic`	게시물에 대한 유기적 노출 수를 확인하세요.
`get_post_engaged_users`	게시물에 참여한 사용자 수를 알아보세요.
`get_post_clicks`	게시물의 클릭 수를 알아보세요.
`get_post_reactions_like_total`	'좋아요' 반응의 총 수를 가져옵니다.

🚀 설정 및 설치

1. 저장소 복제

지엑스피1

2. 🛠️ 설치

빠른 Python 패키지 관리자인 uv를 사용하여 종속성을 설치합니다. uv가 아직 설치되지 않았다면 다음을 실행합니다.

curl -Ls https://astral.sh/uv/install.sh | bash

uv가 설치되면 프로젝트 종속성을 설치하세요.

uv pip install -r requirements.txt

3. 환경 설정

루트 디렉터리에 .env 파일을 만들고 Facebook 페이지 사용자 인증 정보를 추가하세요. 이 정보는 https://developers.facebook.com/tools/explorer 에서 다운로드할 수 있습니다.

FACEBOOK_ACCESS_TOKEN=your_facebook_page_access_token
FACEBOOK_PAGE_ID=your_page_id

🧩 Claude Desktop과 함께 사용

Clade에서 FacebookMCP를 설정하려면:

오픈 클레이드.
설정 → 개발자 → 구성 편집으로 이동합니다.
열리는 구성 파일에 다음 항목을 추가합니다.

"FacebookMCP": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli]",
    "--with",
    "requests",
    "mcp",
    "run",
    "/path/to/facebook-mcp-server/server.py"
  ]
}

✅ 출발 준비가 되었습니다!

이제 Facebook MCP 서버가 완전히 구성되어 Claude Desktop을 구동할 준비가 되었습니다. 이제 자연어 메시지를 통해 게시물을 작성하고, 관리하고, 참여도를 측정할 수 있습니다!

🤝 기여하기

기여, 이슈, 기능 요청을 환영합니다!
자유롭게 저장소를 포크하고 풀 리퀘스트를 제출하세요.

브랜치를 생성합니다: git checkout -b feature/YourFeature
변경 사항을 커밋하세요: git commit -m 'feat: add new feature'
브랜치에 푸시: git push origin feature/YourFeature
풀 리퀘스트를 열어보세요 🎉

facebook-mcp-server

Integrations