A
securityA
licenseA
qualityA Model Context Protocol (MCP) server for managing social media posts, currently supporting X (formerly Twitter).
Last updated -
8
MIT License
Instagram MCP 服务器
使用 Chrome 现有登录会话获取 Instagram 帖子的模型上下文协议 (MCP) 服务器。
特征
具有明确关注点分离的模块化架构
使用 TypeScript 的类型安全实现
改进的错误处理和日志记录
可通过环境变量配置
符合 JSON-RPC 2.0 的通信
自动媒体下载和元数据生成
搜索引擎优化友好的描述生成
建筑学
该服务器采用模块化架构，结构如下：
src/
├── core/ # Core MCP functionality
│ ├── mcp/ # MCP server implementation
│ │ ├── server.ts # Server class
│ │ ├── stdio.ts # StdioServerTransport
│ │ └── index.ts # Barrel exports
│ ├── types/ # Core type definitions
│ │ └── mcp.ts # MCP types
│ └── utils/ # Utility functions
│ ├── config.ts # Configuration management
│ └── errors.ts # Error handling
├── features/ # Feature modules
│ └── instagram/ # Instagram feature
│ ├── types.ts # Instagram types
│ ├── utils/ # Feature utilities
│ │ ├── media.ts # Media handling
│ │ ├── post.ts # Post processing
│ │ └── seo.ts # SEO generation
│ └── instagram.service.ts # Instagram service
├── services/ # Shared services
│ └── browser/ # Browser service
│ ├── types.ts # Browser types
│ └── browser.service.ts # Browser service
├── index.ts # Entry point
└── server.ts # Main server class
配置
服务器需要以下环境变量：
CHROME_USER_DATA_DIR：包含登录会话的 Chrome 用户数据目录的路径
可以通过配置管理器获得其他配置选项：
浏览器设置（视口、超时）
Instagram 设置（延迟、批量大小）
保存目录和文件路径
用法
安装依赖项：
npm install构建服务器：
npm run build运行服务器：
CHROME_USER_DATA_DIR=/path/to/chrome/profile npm start
可用工具
获取 Instagram 帖子
从 Instagram 个人资料中获取最近的帖子。
参数：
username（必填）：用于获取帖子的 Instagram 用户名limit（可选）：要获取的帖子数量（1-50）或“全部”saveDir（可选）：保存媒体文件和元数据的目录delayBetweenPosts（可选）：处理帖子之间等待的毫秒数
例子：
{
"jsonrpc": "2.0",
"id": 1,
"method": "call_tool",
"params": {
"name": "get_instagram_posts",
"arguments": {
"username": "example",
"limit": 10
}
}
}
错误处理
服务器使用标准化的错误代码和消息：
INVALID_REQUEST：请求格式或参数无效INVALID_PARAMS：缺少参数或参数无效METHOD_NOT_FOUND：未知方法或工具INTERNAL_ERROR：服务器端错误
发展
以开发模式启动：
npm run dev运行 linter：
npm run lint
比原版有所改进
模块化架构
清晰的关注点分离
更好的代码组织
更易于维护和扩展
类型安全
全面的 TypeScript 类型
更好的错误捕获
改进的 IDE 支持
错误处理
标准化错误代码
更好的错误消息
适当的错误传播
配置
集中配置
环境变量验证
类型安全的配置访问
代码质量
一致的编码风格
更好的文档
改进的日志记录
测试支持
模块化设计支持测试
依赖注入准备就绪
清晰的界面
执照
麻省理工学院
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
允许通过模型上下文协议 (MCP) 使用 Chrome 现有的登录会话获取 Instagram 帖子的服务器。
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Pinterest Model Context Protocol (MCP) server for image search and information retrievalLast updated -3516MIT License
- AsecurityFlicenseAqualityA lightweight MCP service that enables programmatic downloading of Instagram videos to a specified local path with progress tracking.Last updated -13
- -securityAlicense-qualityA Model Context Protocol server that enables Claude or Cursor to send direct messages on Instagram, allowing AI assistants to interact with Instagram's messaging system.Last updated -135MIT License