jp-lit-mcp

Это MCP-сервер для поиска японской литературы, предназначенный для использования AI-агентами для кросс-поиска по NDL Search, NDL Digital Collections, CiNii Research, J-STAGE, IRDB, JDCat, nihuBridge, протоколам заседаний Парламента и Имперского парламента и другим источникам.

MCP предоставляет инструменты для поиска и получения данных, а прилагаемые навыки (Skills) помогают в диалоге определить, «какую БД использовать», «какие поисковые запросы попробовать» и «как оценить результаты».

Сначала выберите приложение

Самая частая трудность при внедрении — различия в настройках MCP / Skills для разных приложений. Сначала откройте инструкцию для используемого вами приложения.

В качестве предварительного условия требуются Node.js 18 или выше и npm. Для обычного использования не нужно клонировать репозиторий; вы можете запустить MCP-сервер и установщик Skills через npx.

• Инструкция по установке для Cursor

• Инструкция по установке для Claude Code

• Инструкция по установке для Codex CLI

• Инструкция по установке для Codex App

• Установка Skills через GitHub CLI

Кратчайший путь к началу работы

1. Зарегистрируйте npx -y jp-lit-mcp в качестве MCP согласно инструкции для вашего приложения.

2. Установите Skills с помощью npx -y jp-lit-mcp install-skills <app>.

3. Запросите исследование в приложении.

Для диагностики после установки можно использовать легкую команду проверки.

npx -y jp-lit-mcp doctor

Эта команда проверяет версию Node.js (18+), версию пакета, наличие прилагаемых Skills, права на запись в каталоги cache / exports и наличие CINII_RESEARCH_APP_ID. CINII_RESEARCH_APP_ID используется для CiNii и инструмента KAKEN API. Живой API-доступ к внешним БД не выполняется.

Если вы хотите заняться разработкой или добавить источники, клонируйте этот репозиторий и выполните npm install / npm run build / npm run smoke:mcp.

Пример первого запроса:

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

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

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

Что можно делать

• Искать книги, научные статьи, журнальные статьи, протоколы заседаний и исследовательские данные.

• Проверять наличие в фондах и детали библиографии через NDL / CiNii Books и т.д.

• Обращаться к руководствам по поиску и примерам из базы данных сотрудничества справочных служб (Reference Collaborative Database).

• Работать с полнотекстовым OCR, координатами страниц, иллюстрациями и вставками из NDL Digital Collections.

• Проверять подлинность литературы, упомянутой во вставленном тексте.

• Фильтровать, объединять и переупорядочивать сохраненные результаты исследований, а также экспортировать их в форматах Markdown / JSON / CSL JSON.

Результаты исследований, экспортированные в CSL JSON, можно передать в Zotero, Pandoc, инструменты обработки цитирований типа citeproc и другие системы управления библиографией.

Подробности о поддерживаемых источниках и инструментах MCP см. в Техническом справочнике.

Зачем использовать Skills

Хотя поиск возможен и с помощью одного лишь MCP, выбор источника, расширение поисковых запросов и оценка результатов требуют участия пользователя.

При использовании навыка jp-lit-research вы составляете план исследования перед поиском, при необходимости просматривая справочные материалы (Reference Navi) NDL, и формируете источники и поисковые запросы. Исследование не ограничивается одним поиском; предполагается, что вы будете выбирать новые запросы и БД, просматривая промежуточные результаты.

При возврате результатов предоставляется не только библиографическая информация, но и, по возможности, highlights полнотекстового поиска, краткие выдержки из оглавлений и аннотаций, чтобы было понятно, «почему был предложен этот материал». Определение конкретных страниц выполняется отдельным инструментом только при необходимости.

jp-lit-mcp не предназначен для того, чтобы LLM окончательно определяла содержание или академическую значимость литературы. Даже для литературы, текст которой не был прочитан, может проводиться предварительная систематизация на основе заголовков, аннотаций, оглавлений, рецензий, описаний издателей и фрагментов из сети. В таких случаях четко указывается, что это не чтение полного текста, и на чем основана систематизация. Ссылки online=true или ссылки на PDF / HTML / Digital Collections лишь указывают на наличие доступа в сети и не означают, что агент прочитал полный текст.

Кандидаты не просто перечисляются списком, а предварительно ранжируются по приоритету проверки на основе типа материала, издателя/носителя, атрибутов автора, статуса цитирования/рецензирования и статуса проверки текста. Однако ценность литературы не определяется только издателем или носителем. Приоритет проверки — это лишь рабочий ориентир для человека, решающего, что смотреть дальше.

Также поддерживается систематизация результатов после поиска. Операции, такие как сортировка текущих результатов, фильтрация только по онлайн-публикациям, поиск различий или общих черт с предыдущими результатами, в принципе выполняются с повторным использованием сохраненных результатов. Можно выполнять кросс-поиск не только по текущим результатам, но и по ранее сохраненным. cache.hit=true в jp_lit_search указывает на то, что был использован кэш источника. Старый локальный кэш можно удалить после проверки кандидатов с помощью jp_lit_prune_cache.

Для проверки псевдонимов или имен авторов можно использовать вспомогательный инструмент Web NDL Authorities. Например, можно проверить отношения между именами, такими как Такэхиро Сирокава и Тэцуя Асада, и решить, искать ли их отдельно или вместе. Также можно использовать классификации типа NDC для обратного поиска предметных рубрик, чтобы создать кандидатов поисковых запросов для поиска неизвестных книг.

Для обычной установки Skills рекомендуется использовать npx -y jp-lit-mcp install-skills <app> из руководства по установке для каждого приложения. Существует также альтернативный путь через gh skill install в GitHub CLI, но он предназначен для продвинутых пользователей. Подробнее см. Установка Skills через GitHub CLI.

Навык jp-lit-verification извлекает кандидатов на японскую литературу из ответов других сервисов или вашего собственного текста и проверяет их, разделяя на категории: подтверждено существование / частичное совпадение / подозрение на несуществование / подозрение на путаницу.

Подробное руководство по использованию см. в Руководстве пользователя.

Основные поддерживаемые источники

Часто используемые источники:

• ndl_catalog: Вход для поиска в Национальной парламентской библиотеке и информации о фондах.

• ndl_digital: Цифровые коллекции Национальной парламентской библиотеки.

• cinii_articles / cinii_books: Научные статьи, книги и журналы университетских библиотек.

• jstage_articles: Журналы научных обществ и научные статьи.

• irdb: Институциональные репозитории университетов.

• nihu_bridge: Кросс-поиск по специализированным БД в области гуманитарных наук.

• kokkai_minutes / teikoku_minutes: Протоколы заседаний Парламента и Имперского парламента.

• jdcat: Исследовательские данные в области гуманитарных и социальных наук.

• japan_search: Культурные ценности, музеи, региональные материалы.

Список и примечания по реализации собраны в Техническом справочнике.

Документация

• Руководство пользователя: Примеры реальных запросов, процесс исследования, как читать вывод.

• Установка Skills через GitHub CLI: Альтернативный путь через gh skill install.

• Технический справочник: Источники, инструменты MCP, переменные окружения, ограничения, команды разработки и проверки.

• Заметки об условиях использования данных: Требования к отображению и условия использования внешних БД / API.

• Статус реализации: Текущее состояние, последние обновления, заметки после выпуска.

Лицензия

Код этого репозитория распространяется под лицензией MIT License. Подробности см. в LICENSE.

Однако условия использования данных внешних БД / API, к которым обращается MCP, отличаются. Обратите внимание, что условия меняются в зависимости от того, используете ли вы их для личных исследований или для публичных сервисов/общих серверов, накапливающих результаты поиска для предоставления нескольким пользователям. Условия перераспределения, отображения, коммерческого использования и зеркального сохранения см. в Заметках об условиях использования данных и правилах каждого поставщика.