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

Related MCP server: mcp-pinterest

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