Lune

@retrograde-labs/lune-mcp-server

Servidor oficial del Protocolo de Contexto de Modelo (MCP) para Lune Research.

Expone 12 herramientas y 6 flujos de trabajo de investigación guiados (prompts) para buscar, recuperar, comparar y verificar artículos académicos en seguridad, ML, NLP, CV y sistemas, además de recuperación sobre tus propios documentos de workspace subidos. Dos transportes:

• stdio: se ejecuta localmente vía npx @retrograde-labs/lune-mcp-server. Lee LUNE_API_KEY del entorno.
• Streamable HTTP: alojado en https://mcp.luneresearch.com. Pasa tu PAT o token OAuth como Authorization: Bearer ....

Inicio 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"
      }
    }
  }
}

Obtén tu token en https://luneresearch.com/dashboard/settings/credentials.

Herramientas

Herramienta	Descripción
search_papers	Búsqueda híbrida vectorial + BM25 en el corpus
search_papers_many	Ejecuta muchas variantes de consulta en una sola llamada, fusionadas con RRF
search_related_papers	Artículos semánticamente más cercanos a un artículo dado
get_paper_fulltext	Texto completo analizado (markdown o JSON)
get_paper_citations	Grafo de citas (cited_by o cites)
list_conferences	Venues indexados, opcionalmente por categoría
get_conference_papers	Artículos paginados para un venue
extract_from_papers	Extracción estructurada de campos en muchos artículos
verify_claims	Verifica afirmaciones contra el corpus con citas textuales
gather_evidence	Evalúa la suficiencia de evidencia para una tarea, con brechas + próximas consultas
search_research_guidance	Corpus curado de reproducibilidad / metodología
get_research_guidance_doc	Texto completo de un documento de guía

Prompts

Flujos de trabajo de investigación reutilizables, expuestos por clientes MCP como comandos de barra (por ejemplo, /literature_review). Cada uno ejecuta una secuencia guiada de múltiples herramientas fundamentada en el corpus, de modo que las tareas de investigación comunes son un solo comando en lugar de orquestar manualmente las herramientas.

Prompt	Qué hace	Argumentos clave
/literature_review	Encuesta un tema y sintetiza temas, trabajo fundacional vs. reciente, y brechas abiertas	topic (+ opcional venues, since_year)
/find_related_work	Desde tu resumen, encuentra y organiza trabajo previo para citar y distinguir tu contribución	abstract (+ opcional venues)
/compare_papers	Construye una tabla de comparación estructurada entre artículos, leída del texto completo	topic (+ opcional columns)
/verify_draft	Verifica un borrador o lista de afirmaciones contra el corpus, con una cita textual por afirmación	draft
/trace_citations	Traza el linaje de un artículo: sus fundamentos, qué se construyó sobre él y trabajo adyacente	paper
/research_methodology	Asesoría fundamentada sobre diseño de experimentos, ablaciones, evaluación, réplicas o elección de venue	question

Depuración con MCP Inspector

El repositorio fija MCP Inspector 2.3.0 y verifica una configuración de servidor de solo lectura para ambas eras de protocolo. Node 24 de .nvmrc satisface el requisito de Inspector.

Con un PAT en LUNE_API_KEY, esto compila el servidor stdio y abre el catálogo de Inspector con el PAT disponible para procesos locales. Selecciona lune-stdio-modern para ejercitar 2026-07-28:

export LUNE_API_KEY=lune_xxxxxxxxxxxxxxxxxxxxxxxx
bun run mcp:inspect

Sin LUNE_API_KEY, el mismo comando abre el catálogo del servidor sin anulación de entorno. Selecciona lune-remote-modern; Inspector inicia OAuth cuando te conectas. El lanzador nunca pasa una asignación vacía de -e.

La URL impresa contiene un token de Inspector de un solo uso. Abre esa URL en lugar de escribir el puerto manualmente. Inspector permanece en loopback con autenticación habilitada.

El mnemónico de servidor alojado abre el mismo catálogo sin compilar stdio:

bun run mcp:inspect:remote

Los clientes web, CLI y TUI comparten el estado de OAuth en disco. Después de iniciar sesión una vez, la CLI puede verificar el servidor alojado sin abrir otro navegador:

bun run mcp:inspect:remote:check

Las verificaciones locales de stdio usan un token de prueba no productivo y una URL de API deliberadamente muerta. Validan conexión, negociación de versión y el catálogo de herramientas sin consumir cuota:

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

Las configuraciones locales y remotas en apps/mcp/inspector.*.config.json fijan protocolEra explícitamente. Inspector usa por defecto la era heredada, por lo que un lanzamiento sin configurar no prueba el comportamiento de 2026-07-28. Durante la depuración, fija Protocol junto a Console para stdio o Network para HTTP. Prueba argumentos de herramientas inválidos, argumentos de prompts faltantes, ambas eras de protocolo y tokens OAuth expirados, además de llamadas exitosas.

Ejecuta los requisitos congelados del servidor oficial 2026-07-28 con:

bun run mcp:conformance

El arnés de conformidad se vincula solo a 127.0.0.1 e inyecta un token de prueba local. Su línea base nombra verificaciones individuales para capacidades de diagnóstico que Lune no anuncia, como herramientas de imagen y recursos legibles. Cada verificación aplicable aún bloquea la ejecución, y una entrada de línea base obsoleta falla cuando se agrega soporte. Nunca escribas diagnósticos en stdout en stdio. El servidor y su caché escriben diagnósticos en stderr para que el marco JSON-RPC permanezca intacto.

Licencia

MIT