jlbadano/ig-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

203 stars 56 forks 品質 73 トレンド 18MIT

Repository Install

jlbadano/ig-mcpは、https://github.com/jlbadano/ig-mcp.からインポートされたMCPサーバー候補です。

概要

jlbadano/ig-mcpは、https://github.com/jlbadano/ig-mcp.からインポートされたMCPサーバー候補です。

概要（AI 翻訳）

モデルコンテキストプロトコル(MCP)サーバーで、InstagramのGraph APIとシームレスに連携し、AIアプリケーションがInstagramビジネスアカウントとプログラム的にやり取りできるようにします。

特徴

🔧 ツール(モデル制御)

プロフィール情報取得:Instagramビジネスプロフィールの詳細を取得する
メディア投稿を獲得:Instagramアカウントから最近の投稿を取得
メディアインサイトを取得:特定の投稿のエンゲージメント指標を取得する
メディア公開:画像や動画をInstagramにアップロード・公開
アカウントページ取得:アカウントに関連するFacebookページを一覧
会話を取得:InstagramのDM会話を一覧表示(詳細アクセスが必要)
会話メッセージを取得:特定の会話のメッセージを読み取る(高度なアクセスが必要)
DMを送信:Instagramのダイレクトメッセージへの返信(詳細アクセスが必要)

📊 リソース(アプリケーション制御)

プロフィールデータ:フォロワー数、プロフィールなどのプロフィール情報へのアクセス
メディアフィード:エンゲージメント指標を含む最近の投稿
Insights Data:投稿やアカウントのパフォーマンスに関する詳細な分析

💬 プロンプト(ユーザー制御)

このページは 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"
      }
    }
  }
}