Instagram DM Server for AI Assistants

⚡ 快速开始

不到 60 秒即可开始使用：

1. 添加到 MCP 配置中（Claude Desktop、Claude Code 或 Cursor）：

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

2. 与 AI 助手对话：

“读取我的 Instagram 私信”

就这样——现在可以开始使用了。🎉

需要帮助获取 Cookie？请参阅下方的配置。

🎬 效果展示

You:    "Show me my unread Instagram DMs"
Claude: Fetching your inbox...

        📬 Inbox (3 conversations)

        [UNREAD] john_doe (thread_id: 340282366841710300...)
          Last: [2026-03-29 14:23:01] john_doe: Hey, are you free tonight?

        [UNREAD] [GROUP] project_team (thread_id: 340282366841710301...)
          Last: [2026-03-29 13:45:22] alice: Meeting moved to 3pm

        jane_smith (thread_id: 340282366841710302...)
          Last: [2026-03-29 10:12:45] You: Thanks! See you then

You:    "Reply to john_doe: Yeah, let's meet at 7!"
Claude: ✅ Message sent: "Yeah, let's meet at 7!"

✨ 功能

15 个工具，分为三类——管理 Instagram 私信所需的一切：

📥 读取与监控

✏️ 发送与管理

🔍 搜索与发现

📦 安装

npx（推荐——无需安装）

npx mcp-instagram-dm

npm 全局安装

npm install -g mcp-instagram-dm
mcp-instagram-dm

从源代码安装

git clone https://github.com/KynuxDev/mcp-instagram-dm.git
cd mcp-instagram-dm
npm install && npm run build
node dist/index.js

🔧 配置

获取 Cookie

1. 在 Chrome 中打开 instagram.com 并登录
2. 按 F12 → Application 标签页 → Cookies → https://www.instagram.com
3. 复制以下三个值：

💡 提示： 你也可以运行 node get-cookies.js，按照引导完成操作。

环境变量

客户端设置

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

💬 使用示例

只需自然地与 AI 助手对话：

📖 工具参考

🏗️ 架构

┌─────────────────────┐     MCP (stdio)     ┌──────────────────────┐
│   AI Assistant       │◄──────────────────►│   MCP Server          │
│   (Claude, Cursor)   │                     │   src/index.ts        │
└─────────────────────┘                     │   15 tools            │
                                             └──────────┬───────────┘
                                                        │
                                             ┌──────────▼───────────┐
                                             │   Instagram Client    │
                                             │   src/instagram.ts    │
                                             │   Cookie auth + HTTP  │
                                             └──────────┬───────────┘
                                                        │
                                             ┌──────────▼───────────┐
                                             │   Instagram Web API   │
                                             │   (Private endpoints) │
                                             └──────────────────────┘

设计原则：

• 单一依赖 — 仅使用 @modelcontextprotocol/sdk。不依赖 axios、puppeteer，也没有冗余内容。
• 严格 TypeScript — 不使用 any 类型，src/types.ts 中的接口均有完整类型定义
• 自动分页 — 请求 500 条消息，剩余部分由服务端处理，并实施速率限制
• 14+ 种消息类型 — 文本、媒体、语音、Reels、链接、短视频、GIF、帖子、快拍等

🔒 安全

• 会话 Cookie 绝不会被记录或在运行时之外存储
• 所有凭据仅从环境变量读取
• 不会向任何第三方服务发送数据
• 如需报告漏洞，请参阅 SECURITY.md

⚠️ 免责声明

本项目使用 Instagram 的非官方 Web API，该 API 可能随时变更，恕不另行通知。

• 仅供个人使用——请勿用于垃圾信息、群发消息，或违反 Instagram 服务条款的自动化操作
• 您的会话 Cookie 属于敏感凭据——切勿分享或提交
• 本项目与 Meta 或 Instagram 无关联、未获认可，也不存在任何联系
• 使用风险自负——作者不对任何账户限制负责

🤝 贡献

欢迎贡献！有关开发环境设置和指南，请参阅 CONTRIBUTING.md。

如果您愿意在经济上支持本项目，可以考虑 在 GitHub 上赞助。

📄 许可证

MIT — 由 Kynux 用 ❤️ 制作