MCP 服务器

Instagram MCP Server

一个服务器，允许通过模型上下文协议 (MCP) 使用 Chrome 现有的登录会话来获取 Instagram 帖子。 Or, a slightly more natural phrasing: 一个服务器，它允许通过模型上下文协议 (MCP) 利用 Chrome 现有的登录会话来获取 Instagram 帖子。

Tools

get_instagram_posts

Get recent posts from an Instagram profile using existing Chrome login

README

Instagram MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于使用 Chrome 现有的登录会话获取 Instagram 帖子。

特性

模块化架构，关注点分离清晰
使用 TypeScript 的类型安全实现
改进的错误处理和日志记录
可通过环境变量配置
符合 JSON-RPC 2.0 标准的通信
自动媒体下载和元数据生成
SEO 友好的描述生成

架构

服务器遵循模块化架构，结构如下：

src/
├── core/                      # 核心 MCP 功能
│   ├── mcp/                  # MCP 服务器实现
│   │   ├── server.ts        # 服务器类
│   │   ├── stdio.ts         # StdioServerTransport
│   │   └── index.ts         # Barrel exports
│   ├── 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 用户数据目录的路径

其他配置选项可通过配置管理器获得：

浏览器设置（视口、超时）
Instagram 设置（延迟、批量大小）
保存目录和文件路径

用法

安装依赖项：
```
npm install
```
构建服务器：
```
npm run build
```

运行服务器：

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
    }
  }
}