Instagram Dm MCP

🚀 Instagram DM MCP サーバー

このサーバーは、Instagramのダイレクトメッセージを送信するためのモデルコンテキストプロトコル（MCP）サーバーです。 これを使用すると、あなたのアカウントからInstagramのダイレクトメッセージを送信できます（今後、さらに多くの機能が追加されます）。 Claudeに接続したときにできることの例を以下に示します。

https://github.com/user-attachments/assets/9c945f25-4484-4223-8d6b-5bf31243464c

このプロジェクトや他のプロジェクトの更新情報を受け取るには、ここにメールアドレスを入力してください

PS: MCPに関するすべての情報を得るには、Twitterコミュニティに参加してください。

🚀 クイックスタート

ハッカソンへの提出

このInstagram DM MCPを使って何かを作り（技術的なものでも、ノーコードまたはローコードでも構いません）、提出してください！ 制限はありません。誰でも、どこからでも参加できます。

注意: 提出期限は6月27日金曜日午後11:59（PST）です。

3つの現金賞が争われます

1. 5,000米ドル - インターネットを震撼させる（大ヒットする）
2. 2,500米ドル - 技術的な魔法（最もクールな技術的実装）
3. 2,500米ドル - 驚きの賞（私たちを驚かせる）

📦 インストール

前提条件

• Python 3.11以上
• Anthropic Claudeデスクトップアプリ（またはCursor）
• Pip（Pythonパッケージマネージャー）、python -m pip install でインストール
• Instagramアカウント

手順

1. このリポジトリをクローンする

git clone https://github.com/trypeggy/instagram_dm_mcp.git
cd instagram_dm_mcp

2. 依存関係をインストールする

• uvを使用する（推奨）:

uv sync

• Pipを使用する:

pip install -r requirements.txt

3. Instagramの資格情報を設定する Instagramの資格情報を提供するには、2つのオプションがあります。

オプションA: 環境変数（推奨）

クイックセットアップ（推奨）:

ヘルパースクリプトを実行します。

python setup_env.py

これにより、資格情報の入力をインタラクティブに求められ、.envファイルが安全に作成されます。

手動セットアップ:

プロジェクトのルートに.envファイルを作成します。

cp env.example .env

次に、.envを実際の資格情報で編集します。

INSTAGRAM_USERNAME=your_instagram_username
INSTAGRAM_PASSWORD=your_instagram_password

オプションB: コマンドライン引数 コマンドライン引数として資格情報を渡すこともできます（安全性が低い）。

4. MCPサーバーに接続する

Claudeデスクトップの場合:

これをclaude_desktop_config.jsonとして、Claudeデスクトップの設定ディレクトリに保存します。

~/Library/Application Support/Claude/claude_desktop_config.json

Cursorの場合:

これをmcp.jsonとして、Cursorの設定ディレクトリに保存します。

~/.cursor/mcp.json

環境変数を使用した設定（推奨）:

• uvを使用する場合

{
  "mcpServers": {
    "instagram_dms": {
        "command": "uv",
        "args": [
          "run",
          "--directory",
          "PATH/TO/instagram_dm_mcp",
          "python",
          "src/mcp_server.py"
        ]
     }
   }
 }

• Pythonを使用する場合

{
  "mcpServers": {
    "instagram_dms": {
      "command": "python",
      "args": [
        "{{PATH_TO_SRC}}/instagram_dm_mcp/src/ mcp_server.py"
      ]
    }
  }
}

コマンドライン引数を使用した設定:

{
  "mcpServers": {
    "instagram_dms": {
      "command": "python",
      "args": [
        "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
        "--username",
        "{{YOUR_INSTAGRAM_USERNAME}}",
        "--password",
        "{{YOUR_INSTAGRAM_PASSWORD}}"
      ]
    }
  }
}

5. Claudeデスクトップ/Cursorを再起動する Claudeデスクトップを開くと、Instagram DM MCPが利用可能な統合として表示されるはずです。 または、Cursorを再起動します。

💻 使用例

基本的な使用法

以下は、利用可能なすべてのツールとその機能のリストです。

🔧 技術詳細

トラブルシューティング

Instagramログインがハングする場合: サーバーには、ログインのハングを防止するための自動セッション管理が含まれています。セッションファイル（例：username_session.json）は自動的に作成され、実行間で認証状態を維持するために再利用されます。

Claudeデスクトップの統合に関する追加のトラブルシューティングについては、MCPドキュメントを参照してください。このドキュメントには、ログの確認と一般的な問題の解決に役立つヒントが含まれています。

📄 ライセンス

このプロジェクトは、MITライセンスの下でライセンスされています。