Instagram Server Next MCP

🚀 Instagram MCP サーバー

このサーバーは、Chrome の既存のログインセッションを利用して、Instagram の投稿を取得するためのモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• モジュール化アーキテクチャにより、関心事の分離が明確です。
• 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                # 主服务器类

📦 インストール

サーバーには以下の環境変数が必要です。

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

エラー処理

サーバーは標準化されたエラーコードとメッセージを使用しています。

• ERR_NO_API_KEY：API キーが設定されていません。
• ERR_INVALID_ARGUMENT：無効な引数です。
• ERR_DATABASE_ERROR：データベースエラーです。
• ERR_AUTHENTICATION_FAILED：認証に失敗しました。
• ERR_NETWORK：ネットワーク問題です。

終了ステータス

サーバーは以下の終了ステータスを返します。

• 0：成功
• 1：一般的なエラー
• 2：設定エラー
• 3：認証エラー
• 4：データベースエラー
• 5：ネットワークエラー

出力例

$ 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
      },
      // 他の投稿...
    ]
  }
}

注意事項

⚠️ 重要提示

• Node.js と npm がインストールされていることを確認してください。
• 設定ファイルには機密情報が含まれている可能性があるため、適切に保管してください。
• 大量のデータを処理する場合は、ページング機能を有効にすることをおすすめします。