Instagram Server Next MCP

🚀 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 密鑰等，應妥善保管，避免信息洩露。
• 處理大量數據時，建議啟用分頁功能，以提高性能和穩定性。