🔌 MCP, Tool Gateway, canais e Cron

# ~/.hermes/config.yaml
mcpServers:
  filesystem:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/nei/projetos"]
    scope: user

  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: ${GH_TOKEN}
    scope: project

  postgres-prod:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-postgres", "${PG_URL}"]
    scope: user
    enabled: false   # liga via: hermes mcp enable postgres-prod

# ~/.hermes/tools/internal.py
from hermes import tool
from typing import Literal
import httpx

@tool
def jira_create_ticket(
    project: str,
    summary: str,
    description: str,
    priority: Literal["low", "medium", "high"] = "medium",
) -> dict:
    """Cria um ticket no Jira interno e devolve url + key.

    Use quando o usuário pedir 'abre ticket', 'cria task no jira'
    ou descrever um bug que precisa ser rastreado.
    """
    r = httpx.post(
        "https://jira.empresa.com/rest/api/3/issue",
        json={
            "fields": {
                "project": {"key": project},
                "summary": summary,
                "description": description,
                "priority": {"name": priority.capitalize()},
                "issuetype": {"name": "Task"},
            }
        },
        auth=(os.getenv("JIRA_USER"), os.getenv("JIRA_TOKEN")),
        timeout=10,
    )
    r.raise_for_status()
    data = r.json()
    return {"key": data["key"], "url": f"https://jira.empresa.com/browse/{data['key']}"}

# ~/.hermes/channels/discord_channel.py
from hermes.channels import Channel, IncomingMessage, OutgoingMessage
import discord

class DiscordChannel(Channel):
    name = "discord"

    def __init__(self, token: str, allowed_guild: int):
        self.client = discord.Client(intents=discord.Intents.default())
        self.token = token
        self.allowed_guild = allowed_guild

    async def start(self):
        @self.client.event
        async def on_message(msg):
            if msg.author.bot or msg.guild.id != self.allowed_guild:
                return
            await self.on_message(IncomingMessage(
                conversation_id=f"discord:{msg.channel.id}",
                user_id=str(msg.author.id),
                text=msg.content,
                attachments=[a.url for a in msg.attachments],
            ))
        await self.client.start(self.token)

    async def send_message(self, out: OutgoingMessage):
        channel_id = int(out.conversation_id.split(":")[1])
        chan = self.client.get_channel(channel_id)
        await chan.send(out.text)

# Briefing às 9h em dias úteis, executa a skill morning-briefing
$ hermes cron add "0 9 * * 1-5" --skill morning-briefing \
    --channel telegram --user @nei

✓ Job criado: cron-7f3a (próxima execução: amanhã 09:00 BRT)

# Listar jobs
$ hermes cron list
ID         SCHEDULE       TARGET                  LAST RUN    STATUS
cron-7f3a  0 9 * * 1-5    skill:morning-briefing  hoje 09:00  ✓ OK
cron-b21e  */15 * * * *   skill:health-check      14:45       ✓ OK
cron-d8c1  0 18 * * 5     skill:weekly-report     sex 18:00   ✓ OK

# Ver logs de um job
$ hermes cron logs cron-7f3a --tail 5

# Remover
$ hermes cron rm cron-7f3a