返回 MCP 目录
public公开dns本地运行

Instagram Direct Messages

一个基于fastmcp和instagrapi的Instagram私信MCP服务器,支持AI助手读取和发送Instagram私信。

article

README

🚀 Instagram 直接消息 MCP 服务器

本项目是一个基于 fastmcpinstagrapi 构建的 Instagram 直接消息功能的 Model-Consumer Protocol (MCP) 服务器。借助该服务器,AI 助手能够读取消息并发送 Instagram 直接消息。

当前版本:1.3.5

🚀 快速开始

此服务器可助力 AI 助手实现 Instagram 直接消息的读取与发送功能,为相关应用场景提供支持。

✨ 主要特性

  • 读取 Instagram 信箱中的近期直接消息,附带完整的对话信息。
  • 能够向 Instagram 用户发送直接消息。
  • 具备简单问候资源(示例功能)。
  • 设有健康检查端点,并带有状态信息。
  • 采用 stderr 进行适当日志记录,避免 JSON 解析问题。
  • 支持多种身份验证方法,包含环境变量方式。

📦 安装指南

作为 npm 包(推荐)

  1. 全局安装包:
npm install -g instagram-dm-mcp
  1. 运行设置脚本以安装 Python 依赖项:
instagram-dm-mcp-setup
  1. 使用以下命令将服务器注册到 Claude Desktop 并配置凭据:
instagram-dm-mcp install

您将被提示粘贴 Instagram cookies 信息。若您不确定如何获取这些信息,请依照以下步骤操作:在 Chrome 中登录 Instagram,右键点击页面并选择“检查”。转到“应用程序”选项卡,然后在左侧边栏中单击“Cookies”。您会看到一个 cookies 列表,复制 sessionidcsrftokends_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"
    }
  }
}
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端