项目简介

InstaDM MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它允许大型语言模型 (LLM) 应用通过标准化的 MCP 协议与 Instagram Direct Message 功能进行交互。该服务器允许 AI 助手读取用户的 Instagram 收件箱消息并发送消息,从而扩展了 LLM 在社交媒体互动方面的能力。

主要功能点

  • 读取 Instagram DM: 允许 LLM 获取最近的 Instagram 直接消息,包括完整的会话信息。
  • 发送 Instagram DM: 允许 LLM 向 Instagram 用户发送直接消息。
  • 示例 Greeting 资源: 提供一个简单的问候资源作为功能示例。
  • 健康检查: 提供健康检查接口,用于监控服务器状态。
  • 多种认证方式: 支持通过环境变量、命令行参数或配置文件提供 Instagram 认证信息。

安装步骤

  1. 安装 npm 包: 推荐使用 npm 全局安装 'instagram-dm-mcp' 包:

    npm install -g instagram-dm-mcp
  2. 运行安装脚本: 安装 Python 依赖项和设置 CLI 工具:

    instagram-dm-mcp-setup
  3. 配置 Instagram 凭据: 您需要提供 Instagram Cookie 信息以进行身份验证。可以通过以下方式提供:

    • 运行 'instagram-dm-mcp install' 命令,按照提示粘贴 Instagram Cookie 信息('sessionid', 'csrftoken', 'ds_user_id')。
    • 或者,手动创建 'instagram_cookies.json' 文件,并将 Cookie 信息以 JSON 格式存入。
    • 或者,设置环境变量 'INSTAGRAM_SESSION_ID', 'INSTAGRAM_CSRF_TOKEN', 'INSTAGRAM_DS_USER_ID'。

服务器配置

要将 InstaDM MCP Server 集成到 MCP 客户端(例如 Claude Desktop),您需要配置服务器连接信息。以下是一个示例配置,您可以将其添加到 MCP 客户端的配置文件中:

"mcpServers": {
  "InstagramDM": {
    "command": "npx",
    "args": [
      "-y",
      "instagram-dm-mcp",
      "start"
    ],
    "env": {
      // Instagram 凭据 (请替换为您的实际信息,或使用其他凭据提供方式)
      // "INSTAGRAM_SESSION_ID": "您的 sessionid",
      // "INSTAGRAM_CSRF_TOKEN": "您的 csrftoken",
      // "INSTAGRAM_DS_USER_ID": "您的 ds_user_id"
    }
  }
}

配置说明:

  • '"InstagramDM"': 服务器名称,您可以自定义。
  • '"command": "npx"': 启动服务器的命令,这里使用 'npx' 运行 npm 包。
  • '"args": ["-y", "instagram-dm-mcp", "start"]': 传递给 'npx' 的参数,用于启动 'instagram-dm-mcp' 服务器。
  • '"env": { ... }': 环境变量配置。您可以通过环境变量提供 Instagram 凭据。

注意: 请务必替换 '"env"' 中的 Instagram 凭据为您自己的有效信息。为了安全起见,建议使用环境变量或配置文件来管理凭据,而不是直接硬编码在配置中。

基本使用方法

  1. 启动服务器: 在安装完成后,使用以下命令启动 InstaDM MCP Server:

    npx instagram-dm-mcp start

    或者使用 'npm start' 命令(如果从项目根目录启动)。

  2. 在 MCP 客户端中使用: 将上述服务器配置添加到您的 MCP 客户端(如 Claude Desktop)的配置文件中,并启用 "InstagramDM" 服务器。

  3. 通过客户端与 Instagram DM 交互: 您可以使用 MCP 客户端提供的界面或 API,调用服务器提供的工具和资源,例如:

    • 使用 'read_dms' 工具读取最近的 DM 消息。
    • 使用 'send_dm' 工具向指定用户发送 DM 消息。
    • 使用 'greeting://{name}' 资源获取个性化问候语(示例功能)。

信息

分类

通信与社交