Lyrenth

Servidor MCP Lyrenth

Leia a web através do índice do Lyrenth a partir de qualquer cliente MCP.

Expõe três ferramentas:

• read_url transforma uma página web pública em um AIDocument limpo: Markdown estável, além de título, descrição e estrutura, com navegação e conteúdo redundante removidos. Seu agente lê conteúdo limpo e de baixo consumo de tokens em vez de HTML bruto, e cada resultado mostra quantos tokens foram economizados em relação à página original.
• read_urls faz o mesmo para até 20 URLs em uma única chamada em lote.
• check_usage informa seu plano e o uso de créditos.

As leituras são resolvidas pelo cache entre chamadas do Lyrenth e, para domínios verificados, retornam a versão canônica do editor.

Cada ferramenta declara todas as quatro anotações de ferramenta MCP (somente leitura, não destrutiva, idempotente e mundo aberto ou fechado) como booleanos explícitos, e o transporte HTTP acompanha uma suíte de 14 testes cobrindo sua postura de segurança.

Hospedado, sem instalação

Se o seu cliente MCP suporta servidores HTTP remotos com cabeçalho personalizado (os conectores remotos do Claude e do Cursor suportam), não há nada para executar:

• URL: https://api.lyrenth.com/mcp
• Cabeçalho: Authorization: Bearer aiwk_your_key_here

Mesmas três ferramentas, mesma chave. O caminho npx abaixo é para clientes que falam MCP via stdio e para quem prefere um processo local.

Configuração

1. Obtenha uma chave de API gratuita em https://lyrenth.com/signup (2.000 leituras/mês, sem cartão).
2. Adicione o servidor ao seu cliente MCP.

Claude Desktop (um clique)

Baixe lyrenth-mcp.mcpb do último lançamento e abra-o. O Claude Desktop instala o servidor e solicita sua chave de API; não há arquivo de configuração para editar. O pacote contém o mesmo código do pacote npm.

Para compilar você mesmo: ./scripts/build-mcpb.sh.

Claude Desktop / Cursor (configuração manual)

Adicione à sua configuração MCP (Claude Desktop: claude_desktop_config.json):

{
  "mcpServers": {
    "lyrenth": {
      "command": "npx",
      "args": ["-y", "lyrenth-mcp"],
      "env": { "LYRENTH_API_KEY": "aiwk_your_key_here" }
    }
  }
}

Claude Code

claude mcp add lyrenth -e LYRENTH_API_KEY=aiwk_your_key_here -- npx -y lyrenth-mcp

Em seguida, peça ao seu assistente para ler uma página, por exemplo: "Leia https://example.com/article e resuma." Ele chamará read_url e receberá o AIDocument limpo de volta.

Ferramentas

Ferramenta	Argumentos	Retornos
read_url	url (string, obrigatório), fresh (booleano, opcional), max_tokens (inteiro, opcional)	A página como um AIDocument limpo: um cabeçalho curto de proveniência (contagem de tokens + quanto menor que o HTML bruto) mais o corpo em Markdown. fresh: true força uma nova busca em vez da cópia em cache; max_tokens limita o corpo ao seu orçamento de contexto, cortado em um limite limpo de parágrafo ou frase.
read_urls	urls (array de 1 a 20 strings, obrigatório), fresh (booleano, opcional), max_tokens (inteiro, opcional)	Até 20 páginas em uma única chamada, cada uma como um AIDocument limpo, com isolamento de erros por URL (uma URL com falha é reportada e não bloqueia as demais). Cobrado um crédito por URL lida com sucesso.
check_usage	nenhum	Seu plano, créditos usados contra seu limite mensal, créditos restantes e a data de reinício.

Configuração

Variável de ambiente	Obrigatória	Padrão	Observações
LYRENTH_API_KEY	sim	nenhum	Chave gratuita em https://lyrenth.com/signup
LYRENTH_API_URL	não	https://api.lyrenth.com	Substituição para staging ou auto-hospedagem

Por que ler através do Lyrenth

• Mais limpo, mais barato. Um formato AIDocument estável por URL; muito menos tokens do que HTML bruto para um modelo.
• Cache entre chamadas. A mesma URL buscada por muitos agentes reduz-se a um número mínimo de buscas na origem, sendo rápida e amigável à origem.
• Canônico quando verificado. Quando o proprietário de um site verificou com o Lyrenth, você recebe a versão que ele criou, mantida atualizada pelo sinal de alteração dele.

Privacidade

O servidor envia exatamente duas coisas à API do Lyrenth (api.lyrenth.com): as URLs que você pede para ler e sua chave de API para autenticar e medir a chamada. Nada mais sai da sua máquina: nenhum conteúdo de página que você mantém localmente, nenhum contexto de conversa, nenhuma telemetria. Como o Lyrenth trata páginas buscadas e dados de conta é coberto pela política de privacidade: https://www.lyrenth.com/privacy.

Licença

MIT. Veja LICENSE.

Compilação local

npm install
npm run build
LYRENTH_API_KEY=aiwk_... node dist/index.js   # speaks MCP over stdio

Parte do projeto Lyrenth. O formato AIDocument é um contrato aberto; veja https://lyrenth.com/llms-full.txt.