Servidor MCP de Instagram

Un servidor de Protocolo de contexto de modelo (MCP) para obtener publicaciones de Instagram utilizando la sesión de inicio de sesión existente de Chrome.

Características

Arquitectura modular con clara separación de preocupaciones
Implementación segura de tipos usando TypeScript
Manejo y registro de errores mejorados
Configurable a través de variables de entorno
Comunicación compatible con JSON-RPC 2.0
Descarga automática de medios y generación de metadatos
Generación de descripciones optimizadas para SEO

Arquitectura

El servidor sigue una arquitectura modular con la siguiente estructura:

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

Configuración

El servidor requiere las siguientes variables de entorno:

CHROME_USER_DATA_DIR : Ruta al directorio de datos de usuario de Chrome que contiene la sesión de inicio de sesión

Hay opciones de configuración adicionales disponibles a través del administrador de configuración:

Configuración del navegador (ventana gráfica, tiempos de espera)
Configuración de Instagram (retrasos, tamaños de lotes)
Guardar directorios y rutas de archivos

Uso

Instalar dependencias:
npm install
Construir el servidor:
npm run build
Ejecutar el servidor:
CHROME_USER_DATA_DIR=/path/to/chrome/profile npm start

Herramientas disponibles

obtener publicaciones de Instagram

Obtiene publicaciones recientes de un perfil de Instagram.

Parámetros:

username (obligatorio): Nombre de usuario de Instagram del cual obtener publicaciones
limit (opcional): Número de publicaciones a recuperar (1-50) o "todas"
saveDir (opcional): Directorio para guardar archivos multimedia y metadatos
delayBetweenPosts (opcional): milisegundos de espera entre el procesamiento de publicaciones

Ejemplo:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "call_tool",
  "params": {
    "name": "get_instagram_posts",
    "arguments": {
      "username": "example",
      "limit": 10
    }
  }
}

Manejo de errores

El servidor utiliza códigos y mensajes de error estandarizados:

INVALID_REQUEST : Formato o parámetros de solicitud no válidos
INVALID_PARAMS : Parámetros faltantes o no válidos
METHOD_NOT_FOUND : Método o herramienta desconocidos
INTERNAL_ERROR : Errores del lado del servidor

Desarrollo

Iniciar en modo de desarrollo:
npm run dev
Ejecutar linter:
npm run lint

Mejoras respecto al original

Arquitectura modular
- Separación clara de preocupaciones
- Mejor organización del código
- Más fácil de mantener y ampliar
Seguridad de tipos
- Tipos de TypeScript completos
- Mejor detección de errores
- Compatibilidad IDE mejorada
Manejo de errores
- Códigos de error estandarizados
- Mejores mensajes de error
- Propagación adecuada de errores
Configuración
- Configuración centralizada
- Validación de variables de entorno
- Acceso a configuración de tipo seguro
Calidad del código
- Estilo de codificación consistente
- Mejor documentación
- Registro mejorado
Soporte de pruebas
- El diseño modular permite realizar pruebas
- Listo para inyección de dependencia
- Interfaces claras

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

get_instagram_posts

Un servidor que permite obtener publicaciones de Instagram utilizando la sesión de inicio de sesión existente de Chrome a través del Protocolo de contexto de modelo (MCP).

Related Resources

Reddit Discussion about this server

Related MCP Servers

social-media-mcp
angheljf
A
security
A
license
A
quality
A Model Context Protocol (MCP) server for managing social media posts, currently supporting X (formerly Twitter).
Last updated -
3
8
JavaScript
MIT License
mcp-pinterest
terryso
-
security
A
license
-
quality
A Pinterest Model Context Protocol (MCP) server for image search and information retrieval
Last updated -
4
14
TypeScript
MIT License
Instagram Video Downloader MCP Server
handoing
A
security
F
license
A
quality
A lightweight MCP service that enables programmatic downloading of Instagram videos to a specified local path with progress tracking.
Last updated -
1
2
JavaScript
Instagram DM MCP Server
trypeggy
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude or Cursor to send direct messages on Instagram, allowing AI assistants to interact with Instagram's messaging system.
Last updated -
113
Python
MIT License

View all related MCP servers

Instagram MCP Server