项目简介
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 认证信息。
安装步骤
-
安装 npm 包: 推荐使用 npm 全局安装 'instagram-dm-mcp' 包:
npm install -g instagram-dm-mcp -
运行安装脚本: 安装 Python 依赖项和设置 CLI 工具:
instagram-dm-mcp-setup -
配置 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 凭据为您自己的有效信息。为了安全起见,建议使用环境变量或配置文件来管理凭据,而不是直接硬编码在配置中。
基本使用方法
-
启动服务器: 在安装完成后,使用以下命令启动 InstaDM MCP Server:
npx instagram-dm-mcp start或者使用 'npm start' 命令(如果从项目根目录启动)。
-
在 MCP 客户端中使用: 将上述服务器配置添加到您的 MCP 客户端(如 Claude Desktop)的配置文件中,并启用 "InstagramDM" 服务器。
-
通过客户端与 Instagram DM 交互: 您可以使用 MCP 客户端提供的界面或 API,调用服务器提供的工具和资源,例如:
- 使用 'read_dms' 工具读取最近的 DM 消息。
- 使用 'send_dm' 工具向指定用户发送 DM 消息。
- 使用 'greeting://{name}' 资源获取个性化问候语(示例功能)。
信息
分类
通信与社交