🚀 Instagram MCP 服务器
Instagram MCP 服务器是一个借助 Chrome 现有登录会话来抓取 Instagram 帖子的模型上下文协议（MCP）服务器。它能有效利用 Chrome 的登录状态，实现对 Instagram 帖子的抓取操作，为相关数据获取提供了便利。
✨ 主要特性
- 🌟 模块化架构，实现了明确的关注点分离，让代码结构更清晰，易于维护和扩展。
- 🔒 使用 TypeScript 实现类型安全，减少潜在的类型错误，提升代码的可靠性。
- 🛠️ 改进错误处理和日志记录，方便开发者快速定位和解决问题。
- ⚙️ 通过环境变量进行配置，增强了服务器的灵活性和可配置性。
- 📡 符合 JSON - RPC 2.0 通信协议，便于与其他系统进行交互。
- 📥 自动下载媒体文件并生成元数据，为后续的数据处理提供了便利。
- 🌐 制作 SEO 友好的描述，有助于提高搜索引擎的收录和排名。
📦 安装指南
安装依赖项
npm install
构建服务器
npm run build
运行服务器
CHROME_USER_DATA_DIR=/path/to/chrome/profile npm start
💻 使用示例
基础用法
从 Instagram 个人资料中抓取最近的帖子
{
"jsonrpc": "2.0",
"id": 1,
"method": "call_tool",
"params": {
"name": "get_instagram_posts",
"arguments": {
"username": "example",
"limit": 10
}
}
}
命令行运行示例
$ npm start -- get_instagram_posts --username example --limit 10
示例输出
{
"status": "success",
"result": {
"posts": [
{
"id": "post_id_1",
"url": "https://www.instagram.com/post/1234567890/",
"username": "example",
"caption": "这是一个示例帖子。",
"likes": 123,
"comments": 45
}
// 其他帖子...
]
}
}
📚 详细文档
架构
服务器采用模块化架构，具体结构如下：
src/
├── core/ # 核心 MCP 功能
│ ├── mcp/ # MCP 服务器实现
│ │ ├── server.ts # 服务器类
│ │ ├── stdio.ts # StdioServerTransport
│ │ └── index.ts # 导出桶
│ ├── types/ # 核心类型定义
│ │ └── mcp.ts # MCP 类型
│ └── utils/ # 工具函数
│ ├── config.ts # 配置管理
│ └── errors.ts # 错误处理
├── features/ # 功能模块
│ └── instagram/ # Instagram 功能
│ ├── types.ts # Instagram 类型
│ ├── utils/ # 功能工具
│ │ ├── media.ts # 媒体处理
│ │ ├── post.ts # 帖子处理
│ │ └── seo.ts # SEO 生成
│ └── instagram.service.ts # Instagram 服务
├── services/ # 共享服务
│ └── browser/ # 浏览器服务
│ ├── types.ts # 浏览器类型
│ └── browser.service.ts # 浏览器服务
├── index.ts # 入口点
└── server.ts # 主服务器类
配置
服务器需要以下环境变量：
CHROME_USER_DATA_DIR：包含登录会话的 Chrome 用户数据目录路径
此外，通过配置管理器还有其他可用的配置选项：
- 浏览器设置（视图ports口、超时时间）
- Instagram 设置（延迟、批量大小）
- 保存目录和文件路径
可用工具
get_instagram_posts
从 Instagram 个人资料中抓取最近的帖子。 参数：
username（必填）：要抓取的 Instagram 用户名limit（可选）：要抓取的帖子数量（1 - 50）或 "all"saveDir（可选）：保存媒体文件和元数据的目录delayBetweenPosts（可选）：处理帖子之间的等待时间（以毫秒为单位）
错误处理
服务器使用标准化的错误代码和消息：
ERR_NO_API_KEY：未设置 API 密钥ERR_INVALID_ARGUMENT：无效参数ERR_DATABASE_ERROR：数据库错误ERR_AUTHENTICATION_FAILED：身份验证失败ERR_NETWORK：网络问题
退出状态
服务器返回以下退出状态：
0：成功1：一般错误2：配置错误3：认证错误4：数据库错误5：网络错误
🔧 技术细节
模块化架构
服务器的模块化架构使得各个功能模块相互独立，便于开发和维护。核心 MCP 功能、Instagram 功能以及共享服务都被封装在不同的模块中，通过明确的接口进行交互。
类型安全
使用 TypeScript 为代码添加了类型检查，确保了代码的正确性和可维护性。在不同的模块中，都定义了明确的类型，避免了因类型不匹配而导致的错误。
错误处理和日志记录
服务器对错误进行了统一的处理，使用标准化的错误代码和消息，方便开发者快速定位和解决问题。同时，详细的日志记录也为调试和监控提供了有力的支持。
配置管理
通过环境变量和配置管理器，服务器可以灵活地进行配置。不同的环境可以使用不同的配置，提高了服务器的适应性。
JSON - RPC 2.0 通信协议
服务器遵循 JSON - RPC 2.0 通信协议，使得与其他系统的交互变得更加简单和规范。客户端可以通过发送符合该协议的请求来调用服务器的功能。
媒体文件处理和元数据生成
服务器能够自动下载媒体文件并生成元数据，这一功能通过专门的工具函数实现，确保了数据的完整性和可用性。
SEO 友好描述生成
服务器可以生成 SEO 友好的描述，这有助于提高搜索引擎的收录和排名。通过对帖子内容的分析和处理，生成符合 SEO 规则的描述信息。
📄 注意事项
⚠️ 重要提示
- 请确保安装了 Node.js 和 npm，这是服务器运行的基础环境。
- 配置文件可能包含敏感信息，如 API 密钥等，应妥善保管，避免信息泄露。
- 处理大量数据时，建议启用分页功能，以提高性能和稳定性。