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