Instagram DM MCP サーバー

Instagram の DM を送受信するための MCP (Model Context Protocol) サーバーです。

クイックスタート

uv run mcp_server.py

サーバーは stdin/stdout を介して JSON-RPC 2.0 で通信します。

Related MCP server: Instagram MCP Server

セットアップ

1. config/config.json.template を config/config.json にコピーし、sessionid、任意の username、max_messages_per_thread を追加します。

2. config/recipients.json.template を config/recipients.json にコピーします。オプションのエイリアスを持つ Instagram ユーザー名のリストです。

3. .json ファイルは gitignore されています。.template ファイルはガイドとして追跡されます。

ツール

send_dm(recipient, message)

特定の受信者に DM を送信します。

パラメータ:

• recipient (必須) - DM を送信する Instagram ユーザー名

• message (必須) - 送信するメッセージテキスト

read_dm(recipient, max_messages=10)

特定の受信者のスレッドから最新の N 件のメッセージを読み取ります。

パラメータ:

• recipient (必須) - DM を読み取る Instagram ユーザー名

• max_messages (オプション) - スレッドごとの最大メッセージ数 (省略時は設定ファイルの max_messages_per_thread を使用)

list_recipients()

設定済みの全受信者とそのエイリアスを一覧表示します。エージェントはこのツールを使用して、メッセージを送信できる相手を把握する必要があります。

パラメータ: なし

設定

recipients.json 内の受信者にのみ送信してください。スクリプトを直接変更しないでください。

受信者エイリアス

recipients.json では、各エントリにエージェントが使用する alias フィールドを含めることができます:

[
    {
        "username": "john_doe",
        "alias": "John Doe"
    }
]

エイリアスはオプションです。省略した場合はユーザー名が使用されます。設定済みのエイリアスを確認するには、list_recipients ツールを使用してください。プレーンな文字列エントリ (後方互換) もサポートされています:

["john_doe", "jane_smith"]