Instagram Direct Messages

🚀 Instagram 直接消息 MCP 服務器

本項目是一個基於 fastmcp 和 instagrapi 構建的 Model - Consumer Protocol (MCP) 服務器，專門用於實現 Instagram 直接消息功能。藉助此服務器，AI 助手能夠輕鬆讀取消息併發送 Instagram 直接消息。

當前版本：1.3.5

🚀 快速開始

此服務器能讓 AI 助手實現讀取和發送 Instagram 直接消息的功能，為交互提供便利。

✨ 主要特性

• 可讀取 Instagram 信箱中的近期直接消息，且附帶完整的對話信息。
• 支持向 Instagram 用戶發送直接消息。
• 具備簡單問候資源（示例功能）。
• 設有健康檢查端點，並帶有狀態信息。
• 採用 stderr 進行適當日誌記錄，可避免 JSON 解析問題。
• 支持多種身份驗證方法，其中包括使用環境變量。

📦 安裝指南

作為 npm 包（推薦）

1. 全局安裝包：

npm install -g instagram-dm-mcp

2. 運行設置腳本以安裝 Python 依賴項：

instagram-dm-mcp-setup

3. 使用以下命令將服務器註冊到 Claude Desktop 並配置憑據：

instagram-dm-mcp install

您將被提示粘貼 Instagram cookies 信息。若您不確定如何獲取這些信息，可按以下步驟操作：在 Chrome 中登錄 Instagram，右鍵點擊頁面並選擇“檢查”。轉到“應用程序”選項卡，然後在左側邊欄中單擊“Cookies”。您應該會看到一個 cookies 列表。複製 sessionid、csrftoken 和 ds_user_id 的值。

install 命令會自動將 Instagram DM MCP 服務器註冊到 Claude Desktop 並將其添加到您的 Claude Desktop 配置文件中。該命令會配置服務器使用 npx 方法，這使其更易於維護。您還可以將相同的設置複製粘貼到 Claude 或任何其他 MCP 客戶端。

您可以以多種方式提供 Instagram 憑證：

• 使用命令行參數：

instagram-dm-mcp install --session-id YOUR_SESSION_ID --csrf-token YOUR_CSRF_TOKEN --ds-user-id YOUR_DS_USER_ID

• 使用憑據文件：

instagram-dm-mcp install --from-file /path/to/instagram_cookies.json

• 使用環境變量（INSTAGRAM_SESSION_ID、INSTAGRAM_CSRF_TOKEN 和 INSTAGRAM_DS_USER_ID）

安裝程序將在 Claude Desktop 配置文件中將這些憑據作為環境變量添加，生成如下配置：

"mcpServers": {
  // 其他服務器...
  "InstagramDM": {
    "command": "npx",
    "args": [
      "-y",
      "instagram-dm-mcp",
      "start"
    ],
    "env": {
      "INSTAGRAM_SESSION_ID": "your-session-id",
      "INSTAGRAM_CSRF_TOKEN": "your-csrf-token",
      "INSTAGRAM_DS_USER_ID": "your-ds-user-id"
    }
  }
}