MCP Instagram

🚀 Insta MCP Server

Insta MCP Server 是一個用於集成 Instagram 的 MCP（Model Context Protocol）服務器，它能讓你通過 MCP 客戶端全面訪問 Instagram 的各類功能，實現便捷的互動操作。

✨ 主要特性

• 全面訪問：可查看用戶資料、時間線、故事以及詳細的帖子信息。
• 智能互動：能直接在 MCP 客戶端對帖子點贊、評論，還可關注用戶。
• 搜索與發現：具備強大的搜索功能，能查找賬號並探索內容。
• 安全認證：擁有強大的登錄處理機制，支持雙因素認證（2FA）。
• 開發者友好：可與 Claude Desktop、Cursor 等 MCP 兼容工具無縫集成。

📦 安裝指南

此 MCP 服務器可與 Claude Desktop 和 Cursor IDE 等 MCP 兼容客戶端配合使用。按照以下說明在客戶端中配置服務器。

前提條件

• 已安裝 Node.js 18+ 或 20+
• 擁有 Instagram 賬號憑證（IG_USERNAME 和 IG_PASSWORD）

針對 Claude Desktop

1. 找到 Claude Desktop 配置文件：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json
2. 打開配置文件（若文件不存在則創建），並在 mcpServers 部分添加以下內容：

{
  "mcpServers": {
    "mcp-instagram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-instagram"
      ],
      "env": {
        "IG_USERNAME": "your_instagram_username",
        "IG_PASSWORD": "your_instagram_password"
      }
    }
  }
}

3. 替換憑證：
   • 將 your_instagram_username 替換為你的 Instagram 用戶名。
   • 將 your_instagram_password 替換為你的 Instagram 密碼。
4. 重啟 Claude Desktop 使更改生效。之後你應該能在可用工具列表中看到 Instagram MCP 服務器。

針對 Cursor IDE

1. 找到 Cursor MCP 配置文件：
   • 工作區配置：.cursor/mcp.json（在項目根目錄）
   • 全局配置：~/.cursor/mcp.json
2. 打開配置文件（若文件不存在則創建），並在 mcpServers 部分添加以下內容：

{
  "mcpServers": {
    "mcp-instagram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-instagram"
      ],
      "env": {
        "IG_USERNAME": "your_instagram_username",
        "IG_PASSWORD": "your_instagram_password"
      }
    }
  }
}

3. 替換憑證：
   • 將 your_instagram_username 替換為你的 Instagram 用戶名。
   • 將 your_instagram_password 替換為你的 Instagram 密碼。
4. 重啟 Cursor 使更改生效。

替代方法：使用本地安裝

如果你已將倉庫克隆到本地，可以使用絕對路徑：

{
  "mcpServers": {
    "mcp-instagram": {
      "command": "npx",
      "args": [
        "-y",
        "/absolute/path/to/mcp-instagram"
      ],
      "env": {
        "IG_USERNAME": "your_instagram_username",
        "IG_PASSWORD": "your_instagram_password"
      }
    }
  }
}

注意：將 /absolute/path/to/mcp-instagram 替換為你克隆倉庫的實際絕對路徑。

安全注意事項

• 切勿將憑證提交到版本控制。
• 建議在 MCP 配置的 env 部分提供憑證。
• 不會從大語言模型（LLM）請求憑證，必須通過環境變量提供。
• 若你的 Instagram 賬號啟用了 2FA，首次登錄後需使用 instagram_complete_2fa 工具完成 2FA 流程。

驗證安裝

重啟 MCP 客戶端後，你應能在可用服務器列表中看到 Instagram MCP 服務器。你可以通過要求 AI 助手使用以下 Instagram 工具來驗證其是否正常工作：

認證：

• instagram_login - 登錄 Instagram 賬號
• instagram_complete_2fa - 完成雙因素認證
• instagram_logout - 從 Instagram 註銷

資料與內容查看：

• instagram_search_accounts - 搜索 Instagram 賬號
• instagram_get_user_profile - 通過 ID 或用戶名獲取用戶資料信息
• instagram_get_current_user_profile - 獲取已認證用戶自己的資料
• instagram_get_user_posts - 獲取用戶帖子的分頁動態
• instagram_get_post_details - 獲取特定帖子的詳細信息
• instagram_get_user_stories - 獲取用戶的活躍故事
• instagram_get_timeline_feed - 獲取主頁動態（關注賬號的帖子）

互動操作：

• instagram_like_post - 點贊帖子或視頻
• instagram_like_comment - 點贊評論
• instagram_comment_on_post - 對帖子添加評論或回覆評論
• instagram_get_post_comments - 獲取帖子的評論

社交操作：

• instagram_follow_user - 關注 Instagram 用戶

⚠️ 法律免責聲明和風險

重要提示：使用前請閱讀

本軟件使用非官方的 Instagram API 訪問方法，與 Meta Platforms, Inc.（Instagram）沒有關聯、未得到其認可或支持。使用此 MCP 服務器即表示你承認並同意以下內容：

風險和限制

1. 賬號限制：使用本軟件可能導致你的 Instagram 賬號因可疑或自動化活動被標記。Instagram 可能會發出警告、暫時限制賬號功能，或永久停用或刪除你的賬號。
2. 無保證：本軟件的功能不保證持續可用，可能因 Instagram 平臺、安全措施或政策的更改而隨時失效。

責任限制

本軟件的作者和貢獻者按“原樣”提供軟件，不提供任何形式的明示或暗示保證。在任何情況下，作者均不對因軟件或軟件使用而產生的任何索賠、損害或其他責任負責，包括但不限於：

• Instagram 賬號停用、限制或刪除
• 數據、內容丟失或無法訪問 Instagram 服務
• 任何直接、間接、偶然、特殊、後果性或懲罰性損害

使用本軟件即表示你對其使用可能產生的任何後果承擔全部責任。請自行承擔使用風險。

建議

• 使用備用或測試 Instagram 賬號，而非主賬號。
• 監控賬號是否有警告或異常活動。
• 實施合理的速率限制和使用模式，以降低被檢測到的風險。
• 定期查看 Instagram 的服務條款，並遵守所有適用的法律法規。

簡而言之：這是常識問題。不要在一小時內點贊 10000 個帖子或關注所有人。Instagram 不喜歡假裝成人類的機器人。保持冷靜，不要過度使用，你可能就沒問題。也許吧。