Instagram MCPサーバー

Chrome の既存のログインセッションを使用して Instagram の投稿を取得するための Model Context Protocol (MCP) サーバー。

特徴

関心事を明確に分離したモジュラーアーキテクチャ
TypeScriptを使用した型安全な実装
エラー処理とログの改善
環境変数で設定可能
JSON-RPC 2.0準拠の通信
自動メディアダウンロードとメタデータ生成
SEOに適した説明文生成

Related MCP server: mcp-pinterest

建築

サーバーは、次の構造を持つモジュラーアーキテクチャに従います。

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の設定（遅延、バッチサイズ）
ディレクトリとファイルのパスを保存する

使用法

依存関係をインストールします:
```
npm install
```
サーバーを構築します。
```
npm run build
```

サーバーを実行します。

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

利用可能なツール

インスタグラムの投稿を取得する

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