Instagram MCP Server

Instagram MCP Server

一个用于通过 Chrome 现有登录会话获取 Instagram 帖子的模型上下文协议（MCP）服务。

功能

• 模块化架构，职责划分清晰
• 使用 TypeScript 实现类型安全
• 改进错误处理和日志记录
• 可通过环境变量进行配置
• 符合 JSON-RPC 2.0 的通信规范
• 自动下载媒体并生成元数据
• 生成适合 SEO 的描述

架构

该服务采用模块化架构，结构如下：

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 设置（延迟、批次大小）
• 保存目录和文件路径

用法

1. 安装依赖项：

   npm install
   

2. 构建服务：

   npm run build
   

3. 运行服务：

   CHROME_USER_DATA_DIR=/path/to/chrome/profile npm start
   

可用工具

get_instagram_posts

获取 Instagram 个人主页的近期帖子。

参数：

• username（必需）：要获取帖子所属的 Instagram 用户名
• limit（可选）：要获取的帖子数量（1-50）或 "all"
• 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：服务端错误

开发

1. 以开发模式启动：

   npm run dev
   

2. 运行代码检查器：

   npm run lint
   

相较于原始版本的改进

1. 模块化架构

   • 职责划分清晰
   • 代码组织更合理
   • 更易于维护和扩展

2. 类型安全

   • 完善的 TypeScript 类型
   • 更好地捕获错误
   • 改进 IDE 支持

3. 错误处理

   • 标准化的错误代码
   • 更清晰的错误消息
   • 正确传递错误

4. 配置

   • 集中管理配置
   • 验证环境变量
   • 类型安全地访问配置

5. 代码质量

   • 统一的编码风格
   • 更完善的文档
   • 改进日志记录

6. 测试支持

   • 模块化设计便于测试
   • 支持依赖注入
   • 接口清晰

许可证

MIT