Mention MCP Server

Monitore a web e as mídias sociais usando a API do Mention.

Documentação

Servidor MCP Mention

Um servidor Model Context Protocol (MCP) pronto para produção, para escuta social e monitoramento por meio da API do Mention. Construído com TypeScript, tratamento abrangente de erros, registro estruturado e arquitetura modular.

Ferramentas Suportadas

Ferramenta	Descrição
`get_account_info`	Recupera detalhes da conta e plano de assinatura
`get_app_data`	Obtém idiomas, países e fontes disponíveis
`list_alerts`	Lista todos os alertas de monitoramento com paginação
`get_alert`	Obtém informações detalhadas sobre alertas específicos
`create_basic_alert`	Cria alertas com correspondência simples de palavras-chave
`create_advanced_alert`	Cria alertas com sintaxe de consulta booleana
`update_alert`	Modifica critérios e configurações de alertas existentes
`pause_alert`	Pausa temporariamente o monitoramento de alertas específicos
`unpause_alert`	Retoma o monitoramento de alertas pausados
`fetch_mentions`	Recupera menções com filtragem avançada
`fetch_alert_stats`	Obtém estatísticas abrangentes para alertas

Instalação e Uso

Início Rápido com Claude Desktop

Adicione o seguinte ao seu arquivo de configuração do Claude Desktop:

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

Variáveis de Ambiente

Variável	Descrição	Padrão
`MCP_MENTION_API_KEY`	Sua chave da API do Mention (obrigatória)	-
`MCP_MENTION_API_BASE_URL`	URL base personalizada da API	`https://web.mention.com/api`
`MCP_LOG_LEVEL`	Nível de registro (`debug`, `info`, `warn`, `error`)	`info`
`MCP_CONSOLE_LOGGING`	Ativar registro no console (`true`/`false`)	`false`
`MCP_REQUEST_TIMEOUT`	Tempo limite de solicitação em milissegundos	`30000`
`MCP_MAX_RETRIES`	Número máximo de tentativas	`3`

Desenvolvimento

# 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

Os registros são gravados automaticamente em diretórios específicos da 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

Testes

# Run all tests
npm test

# Run tests with coverage
npm run test:coverage

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

Licença

Este projeto está licenciado sob a Licença MIT.