A
securityA
licenseA
qualityA Model Context Protocol (MCP) server for managing social media posts, currently supporting X (formerly Twitter).
Last updated -
8
MIT License
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 installConstruir el servidor:
npm run buildEjecutar 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 publicacioneslimit(opcional): Número de publicaciones a recuperar (1-50) o "todas"saveDir(opcional): Directorio para guardar archivos multimedia y metadatosdelayBetweenPosts(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álidosINVALID_PARAMS: Parámetros faltantes o no válidosMETHOD_NOT_FOUND: Método o herramienta desconocidosINTERNAL_ERROR: Errores del lado del servidor
Desarrollo
Iniciar en modo de desarrollo:
npm run devEjecutar 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)
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
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).
- Características
- Arquitectura
- Configuración
- Uso
- Herramientas disponibles
- Manejo de errores
- Desarrollo
- Mejoras respecto al original
- Licencia
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Pinterest Model Context Protocol (MCP) server for image search and information retrievalLast updated -3516MIT License
- AsecurityFlicenseAqualityA lightweight MCP service that enables programmatic downloading of Instagram videos to a specified local path with progress tracking.Last updated -13
- -securityAlicense-qualityA 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 -135MIT License