MCP Instagram Dm

📨 MCP Instagram DM

使用AI控制您的Instagram DM

使用任何兼容MCP的AI助手，通过自然语言阅读、发送、搜索和管理Instagram私信。

](https://www.npmjs.com/package/mcp-instagram-dm) ](https://www.npmjs.com/package/mcp-instagram-dm) ](https://github.com/KynuxDev/mcp-instagram-dm/stargazers)

  ](https://nodejs.org/)  

A. 模型上下文协议 将Instagram私信与AI助手连接起来的服务器，如 克劳德, 光标，以及任何兼容MCP的客户端。

基于Cookie的身份验证-没有API密钥，没有OAuth，只起作用。

入门指南 · 特性 · 配置 · 工具参考 · 贡献

💡 如果你觉得这很有用，请考虑给它一个⭐ — 它可以帮助其他人发现这个项目！

______________________________________________________________________

⚡ 入门指南

起床跑步 60秒以下：

1.添加到MCP配置中 （克劳德桌面、克劳德代码或光标）：

{
  "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 DM”*

好了，你准备好了。 🎉

需要帮忙拿饼干吗？看 配置 在......下面

🎬 它看起来像什么

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 DM所需的一切：

📥 读取和监视

✏️ 发送和管理

🔍 寻找与发现

📦 安装

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. 打开 instagram.com 在Chrome浏览器中登录
2. 按 F12 → 应用 tab → Cookie → https://www.instagram.com
3. 复制这三个值：

💡 提示： 你也可以跑步 node get-cookies.js 进行引导式演练。

环境变量

客户端设置

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "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"
      }
    }
  }
}

Claude Code

添加到您的项目 .mcp.json:

{
  "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"
      }
    }
  }
}

Cursor

添加 .cursor/mcp.json 在您的项目中：

{
  "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助手自然对话：

📖 工具参考

View all 15 tools with parameters

🏗️ 建筑

┌─────────────────────┐     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没有斧头，没有木偶师，没有臃肿。
• TypeScript严格 --零 any 类型，全类型接口 src/types.ts
• 自动分页 --请求500条消息，服务器以速率限制处理其余消息
• 14+消息类型 --文本、媒体、语音、卷轴、链接、剪辑、GIF、帖子、故事等

🔒 安全

• 会话Cookie是 从未记录或存储 超出运行时间
• 所有凭据仅从环境变量中读取
• 不向任何第三方服务发送数据
• 看 安全.md 用于报告漏洞

⚠️ 免责声明

该项目使用Instagram的 非官方的 网页API，可能会在不另行通知的情况下更改。

• 仅限个人使用 --请勿用于垃圾邮件、群发消息或违反Instagram的自动化 服务条款
• 您的会话Cookie是敏感凭据-- 永远不要分享或承诺
• 这个项目是 不隶属于、不受Meta或Instagram认可或与Meta或Instagram无关
• 使用风险自负——作者不对任何帐户限制负责

🤝 贡献

欢迎投稿！请看 贡献.md 用于开发设置和指南。

如果你想在财务上支持这个项目，可以考虑 .

📄 许可证

______________________________________________________________________

如果这个项目对你有帮助，考虑给它一个⭐