Servidor MCP de Instagram DM

Servidor MCP (Model Context Protocol) para enviar y leer mensajes directos (DMs) de Instagram.

Inicio rápido

uv run mcp_server.py

El servidor se comunica mediante JSON-RPC 2.0 a través de stdin/stdout.

Related MCP server: Instagram MCP Server

Configuración

1. Copia config/config.json.template a config/config.json: añade tu sessionid, username opcional y max_messages_per_thread.

2. Copia config/recipients.json.template a config/recipients.json: lista de nombres de usuario de Instagram con alias opcionales.

3. Los archivos .json están en gitignore; los archivos .template se rastrean como guías.

Herramientas

send_dm(recipient, message)

Envía un DM a un destinatario específico.

Parámetros:

• recipient (obligatorio): nombre de usuario de Instagram al que enviar el DM

• message (obligatorio): texto del mensaje a enviar

read_dm(recipient, max_messages=10)

Lee los últimos N mensajes del hilo de un destinatario específico.

Parámetros:

• recipient (obligatorio): nombre de usuario de Instagram del que leer los DMs

• max_messages (opcional): máximo de mensajes por hilo (usa max_messages_per_thread de la configuración si se omite)

list_recipients()

Lista todos los destinatarios configurados con sus alias. Los agentes deben usar esta herramienta para descubrir a quién pueden enviar mensajes.

Parámetros: Ninguno

Configuración

SOLO envía mensajes a los destinatarios en recipients.json. No modifiques el script directamente.

Alias de destinatarios

En recipients.json, cada entrada puede incluir un campo alias para que lo usen los agentes:

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

El alias es opcional: si se omite, se usa el nombre de usuario. Usa la herramienta list_recipients para ver todos los alias configurados. También se admiten entradas de cadena simple (compatibilidad hacia atrás):

["john_doe", "jane_smith"]