Instagram DM MCP Server

MCP-Server (Model Context Protocol) zum Senden und Lesen von Instagram-DMs.

Schnellstart

uv run mcp_server.py

Der Server kommuniziert über JSON-RPC 2.0 über stdin/stdout.

Related MCP server: Instagram MCP Server

Einrichtung

1. Kopieren Sie config/config.json.template nach config/config.json – fügen Sie Ihre sessionid, optionalen username und max_messages_per_thread hinzu.

2. Kopieren Sie config/recipients.json.template nach config/recipients.json – Liste von Instagram-Benutzernamen mit optionalen Aliasen.

3. Die .json-Dateien sind in .gitignore ausgenommen; die .template-Dateien werden als Anleitungen versioniert.

Tools

send_dm(recipient, message)

Senden Sie eine DM an einen bestimmten Empfänger.

Parameter:

• recipient (erforderlich) – Instagram-Benutzername, an den die DM gesendet werden soll

• message (erforderlich) – Nachrichtentext, der gesendet werden soll

read_dm(recipient, max_messages=10)

Liest die letzten N Nachrichten aus dem Thread eines bestimmten Empfängers.

Parameter:

• recipient (erforderlich) – Instagram-Benutzername, von dem DMs gelesen werden sollen

• max_messages (optional) – Maximale Nachrichten pro Thread (verwendet max_messages_per_thread aus der Konfiguration, wenn nicht angegeben)

list_recipients()

Listet alle konfigurierten Empfänger mit ihren Aliasen auf. Agents sollten dieses Tool verwenden, um herauszufinden, wem sie Nachrichten senden können.

Parameter: Keine

Konfiguration

NUR an Empfänger in recipients.json senden. Ändern Sie das Skript nicht direkt.

Empfänger-Aliase

In recipients.json kann jeder Eintrag ein alias-Feld enthalten, das Agents verwenden können:

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

Der Alias ist optional – wenn er weggelassen wird, wird der Benutzername verwendet. Verwenden Sie das list_recipients-Tool, um alle konfigurierten Aliase zu sehen. Einfache String-Einträge (abwärtskompatibel) werden ebenfalls unterstützt:

["john_doe", "jane_smith"]