jlbadano/ig-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

205 stars 59 forks 품질 73 트렌드 18MIT

Repository Install

jlbadano/ig-mcp는 https://github.com/jlbadano/ig-mcp.에서 임포트 서버 후보입니다.

개요

jlbadano/ig-mcp는 https://github.com/jlbadano/ig-mcp.에서 임포트 서버 후보입니다.

개요(AI 번역)

인스타그램 그래프 API와 원활하게 통합되어 AI 애플리케이션이 인스타그램 비즈니스 계정과 프로그래밍적으로 상호작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

특징

🔧 도구 (모델 제어)

프로필 정보 받기: 인스타그램 비즈니스 프로필 정보 조회
미디어 게시물 가져오기: 인스타그램 계정에서 최근 게시물 가져오기
미디어 인사이트 가져오기: 특정 게시물의 참여 지표 검색
미디어 게시: 인스타그램에 이미지/동영상을 업로드하고 게시하세요
계정 페이지 가져오기: 계정에 연결된 페이스북 페이지 목록
대화 가져오기: 인스타그램 DM 대화 목록 목록 (고급 접근 필요)
대화 메시지 받기: 특정 대화의 메시지 읽기 (고급 접근 필요)
DM 보내기: 인스타그램 다이렉트 메시지에 답장하기 (고급 접근 필요)

📊 리소스 (애플리케이션 제어)

프로필 데이터: 팔로워 수, 프로필 정보 등 프로필 정보 접근
미디어 피드: 참여 지표가 포함된 최근 게시물
인사이트 데이터: 게시물과 계정 성과에 대한 상세한 분석

💬 프롬프트 (사용자 제어)

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Instagram MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Instagram’s Graph API, enabling AI applications to interact with Instagram Business accounts programmatically.

Features

🔧 Tools (Model-controlled)

Get Profile Info: Retrieve Instagram business profile details
Get Media Posts: Fetch recent posts from an Instagram account
Get Media Insights: Retrieve engagement metrics for specific posts
Publish Media: Upload and publish images/videos to Instagram
Get Account Pages: List Facebook pages connected to the account
Get Conversations: List Instagram DM conversations (requires Advanced Access)
Get Conversation Messages: Read messages from specific conversations (requires Advanced Access)
Send DM: Reply to Instagram direct messages (requires Advanced Access)

📊 Resources (Application-controlled)

Profile Data: Access to profile information including follower counts, bio, etc.
Media Feed: Recent posts with engagement metrics
Insights Data: Detailed analytics for posts and account performance

💬 Prompts (User-controlled)

Analyze Engagement: Pre-built prompt for analyzing post performance
Content Strategy: Template for generating content recommendations
Hashtag Analysis: Prompt for hashtag performance evaluation

Prerequisites

Instagram Business Account: Must be connected to a Facebook Page
Facebook Developer Account: Required for API access
Access Token: Long-lived access token with appropriate permissions
Python 3.10+: For running the MCP server (required by MCP dependencies)

Required Instagram API Permissions

Standard Access (available immediately):

instagram_basic
instagram_content_publish
instagram_manage_insights
instagram_manage_comments
pages_show_list
pages_read_engagement
pages_manage_metadata
pages_read_user_content
business_management

Advanced Access (requires Meta App Review):

instagram_manage_messages - Required for Direct Messaging features

⚠️ Instagram DM Features: Reading and sending Instagram direct messages requires Advanced Access approval from Meta. See INSTAGRAM_DM_SETUP.md for the App Review process.

🔑 How to Get Instagram API Credentials

📖 Quick Start: See AUTHENTICATION_GUIDE.md for a 5-minute setup guide!

This section provides a step-by-step guide to obtain the necessary credentials for the Instagram MCP server.

Step 1: Set Up Instagram Business Account

Convert to Business Account (if not already):
- Open Instagram app → Settings → Account → Switch to Professional Account

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "instagram": {
      "command": "python",
      "args": ["/path/to/ig-mcp/src/instagram_mcp_server.py"],
      "env": {
        "INSTAGRAM_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}