Duhlink Instagram Server Next MCP

🚀 Instagram MCP 服務器

Instagram MCP 服務器是一個藉助 Chrome 現有登錄會話來獲取 Instagram 帖子的 Model Context Protocol (MCP) 服務器，能有效解決從 Instagram 自動化獲取和處理帖子內容的問題，為相關業務提供便利。

✨ 主要特性

• 模塊化架構，職責分離明確，提升代碼的可維護性和擴展性。
• 使用 TypeScript 實現類型安全，避免運行時類型錯誤。
• 改進的錯誤處理和日誌記錄，提供更詳細的錯誤信息和處理機制。
• 通過環境變量配置，方便靈活調整服務器參數。
• 符合 JSON - RPC 2.0 的通信協議，確保通信的規範性。
• 自動下載媒體文件並生成元數據，提高數據處理效率。
• 生成對 SEO 友好的描述，有助於提升搜索引擎優化效果。

🏗️ 架構

服務器採用模塊化架構，結構如下：

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                # 主服務器類

📦 安裝指南

安裝依賴項

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": {
    "tool": "get_instagram_posts",
    "username": "target_user",
    "limit": 10,
    "saveDir": "/path/to/save",
    "delayBetweenPosts": 1000
  }
}

📚 詳細文檔

配置

服務器需要以下環境變量：

• CHROME_USER_DATA_DIR：包含登錄會話的 Chrome 用戶數據目錄路徑

此外，通過配置管理器還可以設置其他配置選項：

• 瀏覽器設置（視圖ports 口、超時時間）
• Instagram 設置（延遲時間、批量大小）
• 保存目錄和文件路徑

錯誤處理

服務器使用以下標準錯誤代碼和信息：

• INVALID_REQUEST：請求格式無效或缺少必需參數。
• AUTHENTICATION_ERROR：無法驗證用戶身份。
• RATE_LIMITED：達到 Instagram 的速率限制。
• INTERNAL_SERVER_ERROR：服務器內部錯誤。

開發模式

啟動開發模式

npm run dev

檢查代碼格式

npm run lint

執行單元測試

npm test

🔧 技術細節

對比原始版本，主要改進如下：

• 模塊化架構：提高了代碼的可維護性和擴展性。
• 類型安全：通過 TypeScript 避免了運行時類型錯誤。
• 錯誤處理：提供了更詳細的錯誤信息和處理機制。
• 代碼質量：遵循最佳實踐，確保代碼的一致性和可讀性。

總體而言，該項目結構清晰，功能完善，適合用於自動化獲取和處理 Instagram 帖子內容。