Lune

@retrograde-labs/lune-mcp-server

Servidor oficial do Model Context Protocol para Lune Research.

Expõe 12 ferramentas e 6 fluxos de pesquisa guiados (prompts) para buscar, recuperar, comparar e verificar artigos acadêmicos em conferências de segurança, ML, NLP, CV e sistemas, além de recuperação sobre seus próprios documentos de workspace enviados. Dois transportes:

• stdio: execute localmente via npx @retrograde-labs/lune-mcp-server. Lê LUNE_API_KEY do ambiente.
• Streamable HTTP: hospedado em https://mcp.luneresearch.com. Envie seu PAT ou token OAuth como Authorization: Bearer ....

Início rápido (Claude Desktop, Cursor, etc.)

{
  "mcpServers": {
    "lune-research": {
      "command": "npx",
      "args": ["-y", "@retrograde-labs/lune-mcp-server"],
      "env": {
        "LUNE_API_KEY": "lune_your_personal_access_token"
      }
    }
  }
}

Obtenha seu token em https://luneresearch.com/dashboard/settings/credentials.

Ferramentas

Ferramenta	Descrição
search_papers	Busca híbrida vetorial + BM25 no corpus
search_papers_many	Execute muitas variantes de consulta em uma chamada, mescladas por RRF
search_related_papers	Artigos semanticamente mais próximos de um artigo dado
get_paper_fulltext	Texto completo analisado (markdown ou JSON)
get_paper_citations	Grafo de citações (cited_by ou cites)
list_conferences	Conferências indexadas, opcionalmente por categoria
get_conference_papers	Artigos paginados para uma conferência
extract_from_papers	Extração estruturada de campos em muitos artigos
verify_claims	Verifique afirmações contra o corpus com citações
gather_evidence	Avalie a suficiência de evidências para uma tarefa, com lacunas + próximas consultas
search_research_guidance	Corpus curado de reprodutibilidade / metodologia
get_research_guidance_doc	Texto completo de um documento de orientação

Prompts

Fluxos de pesquisa reutilizáveis, apresentados pelos clientes MCP como comandos de barra (ex.: /literature_review). Cada um executa uma sequência guiada de múltiplas ferramentas fundamentada no corpus, para que tarefas comuns de pesquisa sejam um único comando em vez de orquestrar as ferramentas manualmente.

Prompt	O que faz	Argumentos principais
/literature_review	Pesquise um tópico e sintetize temas, trabalhos fundamentais vs. recentes e lacunas em aberto	topic (+ opcional venues, since_year)
/find_related_work	A partir do seu resumo, encontre e organize trabalhos anteriores para citar e distinguir sua contribuição	abstract (+ opcional venues)
/compare_papers	Construa uma tabela de comparação estruturada entre artigos, lida do texto completo	topic (+ opcional columns)
/verify_draft	Verifique um rascunho ou lista de afirmações contra o corpus, com uma citação verbatim por afirmação	draft
/trace_citations	Trace a linhagem de um artigo: suas fundações, o que foi construído sobre ele e trabalhos adjacentes	paper
/research_methodology	Orientação fundamentada sobre design de experimentos, ablações, avaliação, réplicas ou escolha de conferência	question

Depuração com o MCP Inspector

O repositório fixa o MCP Inspector 2.3.0 e inclui uma configuração de servidor somente leitura para ambas as eras de protocolo. Node 24 de .nvmrc atende ao requisito do Inspector.

Com um PAT em LUNE_API_KEY, isso compila o servidor stdio e abre o catálogo do Inspector com o PAT disponível para processos locais. Selecione lune-stdio-modern para exercitar 2026-07-28:

export LUNE_API_KEY=lune_xxxxxxxxxxxxxxxxxxxxxxxx
bun run mcp:inspect

Sem LUNE_API_KEY, o mesmo comando abre o catálogo do servidor sem uma substituição de ambiente. Selecione lune-remote-modern; o Inspector inicia OAuth quando você conecta. O lançador nunca passa uma atribuição vazia de -e.

A URL impressa contém um token do Inspector de uso único. Abra essa URL em vez de digitar a porta manualmente. O Inspector permanece em loopback com autenticação habilitada.

O mnemônico do servidor hospedado abre o mesmo catálogo sem compilar o stdio:

bun run mcp:inspect:remote

Os clientes web, CLI e TUI compartilham o estado OAuth no disco. Após entrar uma vez, o CLI pode verificar o servidor hospedado sem abrir outro navegador:

bun run mcp:inspect:remote:check

As verificações locais de stdio usam um token de teste não produtivo e uma URL de API deliberadamente inativa. Elas validam conexão, negociação de versão e o catálogo de ferramentas sem consumir cota:

bun run mcp:inspect:check
bun run mcp:inspect:check:legacy
bun run mcp:inspect:tui

As configurações locais e remotas em apps/mcp/inspector.*.config.json fixam protocolEra explicitamente. O Inspector usa como padrão a era legada, então um lançamento não configurado não prova o comportamento de 2026-07-28. Durante a depuração, fixe Protocol ao lado de Console para stdio ou Network para HTTP. Teste argumentos de ferramenta inválidos, argumentos de prompt ausentes, ambas as eras de protocolo e tokens OAuth expirados, além de chamadas bem-sucedidas.

Execute os requisitos oficiais congelados do servidor 2026-07-28 com:

bun run mcp:conformance

O harness de conformidade vincula apenas 127.0.0.1 e injeta um token de teste local. Sua linha de base nomeia verificações individuais para capacidades de diagnóstico que a Lune não anuncia, como ferramentas de imagem e recursos legíveis. Toda verificação aplicável ainda bloqueia a execução, e uma entrada de linha de base desatualizada falha quando o suporte é adicionado. Nunca escreva diagnósticos no stdout em stdio. O servidor e seu cache escrevem diagnósticos no stderr para que o enquadramento JSON-RPC permaneça intacto.

Licença

MIT