JinDaGe - insta-mcp MCP Details

article

README

🚀 Instagram 直接消息 MCP 服务器

这是一个用于 Instagram 直接消息功能的 Model-Consumer Protocol (MCP) 服务器，基于 fastmcp 和 instagrapi 构建。借助该服务器，AI 助手能够读取消息并发送 Instagram 直接消息。

当前版本：1.3.5

✨ 主要特性

读取 Instagram 信箱中的最近直接消息，并提供全面的对话信息。
可向 Instagram 用户发送直接消息。
具备简单问候功能示例（演示功能）。
设有健康检查端点，带有状态信息。
能正确将日志记录到 stderr，避免 JSON 解析问题。
支持多种身份验证方法，包括使用环境变量。

📦 安装指南

作为 npm 包安装（推荐）

全局安装包：

npm install -g instagram-dm-mcp

运行设置脚本以安装 Python 依赖项：

instagram-dm-mcp-setup

使用 instagram-dm-mcp 注册服务器并与 Claude Desktop 配置凭证：

instagram-dm-mcp install

您将被提示粘贴 Instagram cookie 信息。若不确定如何获取这些信息，可在 Chrome 中登录 Instagram，右键点击页面并选择“检查”。转到“应用程序”选项卡，然后在左侧边栏中单击“Cookie”，您会看到一个 Cookie 列表，复制 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"
    }
  }
}

insta-mcp