Mention MCP Server

Monitorear la web y redes sociales usando la API de Mention.

Documentación

Mention MCP Server

Un servidor Model Context Protocol (MCP) listo para producción para escucha social y monitoreo a través de la API de Mention. Construido con TypeScript, manejo integral de errores, registro estructurado y arquitectura modular.

Herramientas compatibles

Herramienta	Descripción
`get_account_info`	Obtener detalles de la cuenta y plan de suscripción
`get_app_data`	Obtener idiomas, países y fuentes disponibles
`list_alerts`	Listar todas las alertas de monitoreo con paginación
`get_alert`	Obtener información detallada sobre alertas específicas
`create_basic_alert`	Crear alertas con coincidencia simple de palabras clave
`create_advanced_alert`	Crear alertas con sintaxis de consulta booleana
`update_alert`	Modificar criterios y configuraciones de alertas existentes
`pause_alert`	Pausar temporalmente el monitoreo de alertas específicas
`unpause_alert`	Reanudar el monitoreo de alertas pausadas
`fetch_mentions`	Obtener menciones con filtrado avanzado
`fetch_alert_stats`	Obtener estadísticas completas para alertas

Instalación y uso

Inicio rápido con Claude Desktop

Agrega lo siguiente a tu archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "mention": {
      "command": "npx",
      "args": ["-y", "@maelitop/mention-mcp-server"],
      "env": {
        "MCP_MENTION_API_KEY": "your_mention_api_key_here"
      }
    }
  }
}

Variables de entorno

Variable	Descripción	Predeterminado
`MCP_MENTION_API_KEY`	Tu clave de API de Mention (obligatoria)	-
`MCP_MENTION_API_BASE_URL`	URL base de API personalizada	`https://web.mention.com/api`
`MCP_LOG_LEVEL`	Nivel de registro (`debug`, `info`, `warn`, `error`)	`info`
`MCP_CONSOLE_LOGGING`	Habilitar registro en consola (`true`/`false`)	`false`
`MCP_REQUEST_TIMEOUT`	Tiempo de espera de solicitud en milisegundos	`30000`
`MCP_MAX_RETRIES`	Número máximo de reintentos	`3`

Desarrollo

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

# Run linting and type checking
npm run ci

Registro

Los registros se escriben automáticamente en directorios específicos de la plataforma:

macOS: ~/Library/Logs/mention-mcp-server/mention-mcp-server.log
Windows: ~/AppData/Local/mention-mcp-server/logs/mention-mcp-server.log
Linux: ~/.local/share/mention-mcp-server/logs/mention-mcp-server.log

Pruebas

# Run all tests
npm test

# Run tests with coverage
npm run test:coverage

# Run tests in watch mode
npm run test -- --watch

Licencia

Este proyecto está licenciado bajo la Licencia MIT.