Skip to main content
Glama
roclee2692

email-firewall

by roclee2692

Email Triage Agent

Triaje de correo electrónico determinista para Hermes Agent. Clasifica los mensajes en P0–P3 o REVIEW, emite el contrato compartido pif.event.v1 y permite que Hermes entregue el resultado a través de su pasarela Feishu existente.

确定性的 Hermes 邮件分诊 MCP:不确定就保留,V1 永不删除、永不发信,飞书凭证继续由 Hermes 管理。

Por qué / 设计理念

  • Reducir la información, no crear más.

  • P0 es inmediato; P1 espera un resumen; P2/P3 son solo de auditoría.

  • Los conflictos de autenticación del remitente y la baja confianza se convierten en REVIEW/HOLD.

  • La retroalimentación humana actualiza un rastro de reglas JSONL externo, nunca los pesos del modelo.

  • El adaptador opcional se conecta a buzones reales con IMAP de solo lectura. Nunca ejecuta cambios de Delete, Send, Move o Seen.

Related MCP server: inbox-to-action-mcp

Ejecución local

npm ci
npm test
npm run demo

Comandos del adaptador de buzón real:

node src/adapter-cli.js test --account qq-main
node src/adapter-cli.js poll --accounts qq-main

Las credenciales son referencias a elementos del llavero de macOS o variables de entorno; las contraseñas y tokens literales son rechazados por la validación de configuración. Consulte la guía del adaptador de buzón de solo lectura.

Clasificación única:

node src/cli.js --json '{"sender":"no-reply@accounts.google.com","subject":"New login detected","auth":{"spf":"pass","dkim":"pass","dmarc":"pass"},"protectedSender":true}'

Añadir a Hermes en macOS

Hermes descubre herramientas MCP stdio desde ~/.hermes/config.yaml. Clone e instale, luego use una ruta absoluta:

git clone https://github.com/roclee2692/email-triage-agent.git ~/Projects/email-triage-agent
cd ~/Projects/email-triage-agent && npm ci
hermes mcp add email-firewall --command node --args "$HOME/Projects/email-triage-agent/src/mcp.js"
hermes mcp test email-firewall

Hermes registra herramientas con nombres como mcp_email_firewall_triage_email. El servidor nunca necesita secretos de Feishu: Hermes ya posee el canal de Feishu y presenta o programa el mensaje devuelto.

Herramientas

  • triage_email

  • render_feishu_email

  • record_email_feedback

  • get_email_policy

  • poll_email_accounts

  • test_email_account

  • acknowledge_email_events

El repositorio complementario es crypto-market-sentinel. Ambos devuelven el mismo sobre de eventos, por lo que un solo prompt de Hermes puede aplicar la misma política de urgente/resumen/auditoría.

Consulte configuración de Hermes en macOS y el contrato de eventos PIF compartido.

Licencia

MIT. Consulte LICENSE.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    One-pass agentic inbox triage as an MCP server: fetch unread Gmail → classify (action_needed/fyi/newsletter/noise) → summarize → extract tasks → draft replies as Gmail DRAFTS (never sends) → flag calendar → write a triage report. Four stdio tools (fetch_emails, save_gmail_draft, append_tasks, write_report); the host is the LLM, so it runs keyless in Claude Code. Gmail scopes: readonly + compose
    4
    59 PyPI
    2
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables multi-channel inbox message priority classification and response SLA tracking through MCP-compliant clients, providing deterministic priority scoring and structured execution telemetry.
    8
    -