Instagram Direct Messages

🚀 Instagram 直接消息 MCP 服务器

本项目是一个基于 fastmcp 和 instagrapi 构建的 Instagram 直接消息功能的 Model-Consumer Protocol (MCP) 服务器。借助该服务器，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"
}
}
}