jp-lit-mcp

Un servidor MCP para la exploración de literatura japonesa diseñado para que los agentes de IA utilicen de forma transversal NDL Search, NDL Digital Collections, CiNii Research, J-STAGE, IRDB, JDCat, nihuBridge, las actas de la Dieta Nacional y del Parlamento Imperial, entre otros.

MCP proporciona las herramientas para buscar y obtener información, mientras que las Skills incluidas ayudan en el diálogo a decidir "qué base de datos usar", "qué términos de búsqueda probar" y "cómo evaluar los resultados".

Primero, elige tu aplicación

El mayor obstáculo en la introducción suele ser la diferencia en la configuración de MCP / Skills según la aplicación. Por favor, abre primero las instrucciones de la aplicación que vas a utilizar.

Como requisito previo, se necesita Node.js 18 o superior y npm. Para un uso normal, no es necesario clonar el repositorio; puedes ejecutar el servidor MCP y el instalador de Skills desde npx.

• Instrucciones de instalación para Cursor

• Instrucciones de instalación para Claude Code

• Instrucciones de instalación para Codex CLI

• Instrucciones de instalación para Codex App

• Instalar Skills con GitHub CLI

Cómo empezar rápidamente

1. Registra npx -y jp-lit-mcp como MCP siguiendo las instrucciones de instalación de tu aplicación.

2. Instala las Skills con npx -y jp-lit-mcp install-skills <app>.

3. Solicita la investigación en la aplicación.

Para el diagnóstico después de la instalación, puedes usar el comando de diagnóstico ligero.

npx -y jp-lit-mcp doctor

Este comando verifica Node.js 18 o superior, la versión del paquete, las Skills incluidas, la capacidad de escritura en los directorios cache / exports y la presencia de CINII_RESEARCH_APP_ID. CINII_RESEARCH_APP_ID se utiliza para las herramientas de CiNii y KAKEN API. No realiza acceso a la API en vivo a bases de datos externas.

Solo si deseas desarrollar o añadir fuentes, clona este repositorio y ejecuta npm install / npm run build / npm run smoke:mcp.

Ejemplo de solicitud inicial:

文献DBで、近代日本の労働文化について、論文と図書を探してください。

文献DBを始めます。明治期の俳句雑誌について、最初に見るべき資料と、使うべき DB を教えてください。

文献検証で、この文章に出てくる文献の実在性を確認してください。

Qué puedes hacer

• Buscar libros, artículos académicos, artículos de revistas, actas de congresos y datos de investigación.

• Verificar la disponibilidad y detalles bibliográficos en NDL / CiNii Books, etc.

• Consultar manuales y casos de estudio de la Base de Datos Cooperativa de Referencia.

• Manejar el texto completo OCR, coordenadas de página, ilustraciones y figuras de la Colección Digital de NDL.

• Verificar la existencia de literatura mencionada en textos pegados.

• Filtrar, integrar y reorganizar los resultados de investigación guardados, y exportarlos en Markdown / JSON / CSL JSON.

Los resultados exportados en CSL JSON pueden transferirse a herramientas de gestión bibliográfica y procesamiento de citas como Zotero, Pandoc o herramientas basadas en citeproc.

Para obtener detalles sobre las fuentes compatibles y las herramientas MCP, consulta la Referencia técnica.

Por qué usar Skills

Aunque puedes buscar solo con MCP, el usuario debe pensar en la selección de fuentes, la expansión de términos de búsqueda y la evaluación de resultados.

Al usar la Skill jp-lit-research, puedes planificar la investigación antes de buscar y, si es necesario, consultar la base de datos de referencia o NDL Research Navi para estructurar las fuentes y los términos de búsqueda. La investigación no termina en una sola búsqueda; se basa en la premisa de volver a elegir la consulta o la base de datos mientras se observan los candidatos.

Al devolver resultados, no solo se incluye información bibliográfica, sino también highlights de la búsqueda de texto completo y, en la medida de lo posible, breves extractos de resúmenes o tablas de contenido para que se entienda "por qué se presentó ese material". La identificación de la ubicación de la página se realiza con una herramienta separada solo cuando es necesario.

jp-lit-mcp no está diseñado para que el LLM tome la decisión final sobre la comprensión del contenido o la posición académica de la literatura. Incluso para literatura cuyo cuerpo no se ha leído, a veces se realiza una organización preliminar basada en el título, resumen, tabla de contenido, reseñas, presentaciones de editoriales o fragmentos en la web. En tales casos, se especifica claramente que no es una lectura del cuerpo del texto y en qué se basa la organización. Los enlaces online=true o a PDF / HTML / Colección Digital solo indican que hay una entrada en línea, no significan que el agente haya leído el cuerpo del texto.

Los candidatos no solo se presentan de forma plana, sino que se les asigna una prioridad de verificación tentativa basada en el tipo de material, editorial/medio, atributos del autor, estado de citas/reseñas y estado de confirmación del cuerpo del texto. Sin embargo, el valor de la literatura no se determina únicamente por la editorial o el medio. La prioridad de verificación es una guía de trabajo para que el humano decida qué ver a continuación.

También admite la organización de resultados después de la búsqueda. Operaciones como reordenar los resultados actuales, limitar solo a publicaciones en línea, o calcular diferencias/puntos comunes con resultados anteriores se realizan, en principio, reutilizando los resultados guardados. Puedes buscar e integrar no solo los resultados de búsqueda actuales, sino también los resultados de búsqueda guardados en el pasado. cache.hit=true en jp_lit_search indica que se utilizó la caché de origen de esa reutilización. La caché local antigua se puede eliminar después de verificar los candidatos con jp_lit_prune_cache.

También se pueden utilizar herramientas auxiliares que emplean Web NDL Authorities para confirmar seudónimos o nombres alternativos de personas y encabezamientos de materia. Por ejemplo, puedes confirmar la relación de nombres como Takehiko Shikagawa y Tetsuya Asada, y decidir si buscar por nombre separado o en conjunto. También puedes crear candidatos de términos de búsqueda para encontrar libros desconocidos mediante la búsqueda inversa de encabezamientos de materia a partir de clasificaciones como NDC.

Para la instalación normal de Skills, recomendamos npx -y jp-lit-mcp install-skills <app> que se encuentra en la guía de instalación para cada aplicación. Existe otra ruta usando gh skill install de GitHub CLI, pero esta es para usuarios avanzados. Para más detalles, consulta Instalar Skills con GitHub CLI.

La Skill jp-lit-verification extrae candidatos de literatura japonesa que aparecen en respuestas de otros servicios o en tus propios textos, y los verifica clasificándolos en confirmados, coincidencia parcial, sospecha de no existencia o sospecha de confusión.

Para obtener instrucciones detalladas, consulta la Guía de uso.

Principales fuentes compatibles

Las fuentes de uso frecuente son las siguientes:

• ndl_catalog: Entrada para consultar la Biblioteca Nacional de la Dieta e información de existencias.

• ndl_digital: Colección Digital de la Biblioteca Nacional de la Dieta.

• cinii_articles / cinii_books: Artículos académicos, libros y revistas de bibliotecas universitarias.

• jstage_articles: Revistas académicas y artículos de investigación.

• irdb: Repositorios institucionales universitarios.

• nihu_bridge: Búsqueda transversal de bases de datos especializadas en humanidades.

• kokkai_minutes / teikoku_minutes: Actas de la Dieta Nacional y del Parlamento Imperial.

• jdcat: Datos de investigación en humanidades y ciencias sociales.

• japan_search: Bienes culturales, museos y materiales regionales.

La lista y las notas de implementación se resumen en la Referencia técnica.

Documentación

• Guía de uso: Ejemplos de solicitudes reales, flujo de investigación, cómo leer la salida.

• Instalar Skills con GitHub CLI: Otra ruta usando gh skill install.

• Referencia técnica: Fuentes, herramientas MCP, variables de entorno, restricciones, comandos de desarrollo/verificación.

• Notas sobre las condiciones de uso de datos: Requisitos de visualización y condiciones de uso de bases de datos / API externas.

• Estado de implementación: Estado actual, actualizaciones recientes, notas post-lanzamiento.

Licencia

El código de este repositorio tiene una MIT License. Consulta LICENSE para más detalles.

Sin embargo, las condiciones de uso de los datos de las bases de datos / API externas a las que accede MCP son diferentes. Los puntos a tener en cuenta cambian entre el uso de investigación en terminales personales y la operación de servicios públicos o servidores compartidos que acumulan resultados de búsqueda y los proporcionan a múltiples usuarios. Para las condiciones de redistribución, visualización, uso comercial y almacenamiento tipo espejo, consulta las Notas sobre las condiciones de uso de datos y los términos de cada proveedor.