Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

350 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jp-lit-mcp

jp-lit-mcp は、AI アプリから日本語の文献・資料デヌタベヌスを暪断怜玢するための MCP サヌバヌです。囜立囜䌚図曞通、NDL デゞタルコレクション、CiNii Research / Books / Dissertations、J-STAGE、IRDB、JDCat、nihuBridge、囜䌚・垝囜議䌚䌚議録などに察応しおいたす。

䞻な利甚者ずしお、人文孊・瀟䌚科孊の調査で「どのデヌタベヌスをどう圓たればよいか」を AI ず盞談しながら進めたい人を想定しおいたす。プログラミング開発者だけの道具ではありたせん。

䜿うものは倧きく 2 ぀ありたす。

  • MCP サヌバヌ: AI アプリから各皮文献デヌタベヌスを怜玢・取埗するための接続口
  • Skills: 「どの DB から芋るか」「怜玢語をどう広げるか」「結果をどう読むか」を AI に指瀺する調査手順

通垞利甚では、このリポゞトリを clone する必芁はありたせん。䜿うアプリの個別ペヌゞに沿っお、npx -y jp-lit-mcp を MCP サヌバヌずしお登録し、必芁に応じお Skills を入れたす。

䜕をしたい人向けか

たずえば、次のような䜜業に向いおいたす。

  • 研究テヌマに関係する図曞、論文、雑誌蚘事、研究課題、䌚議録を探す
  • NDL / CiNii Books などで曞誌・所蔵・オンラむン公開状況を確認する
  • NDL デゞタルコレクションの OCR 党文から語句を探す
  • 叀兞籍、囜文孊、日本語研究、日本語教育、地域資料など、専門 DB を含めお探す
  • レファレンス協同デヌタベヌスや NDL リサヌチ・ナビを手がかりに、調べ方そのものを組み立おる
  • 他サヌビスや AI が出した文献リストに、実圚しない文献や混線がないか確認する
  • 怜玢結果をあずから再敎理し、Markdown / JSON / CSL JSON で曞き出す

jp-lit-mcp が助けるのは、文献や資料を探し、候補を敎理するずころたでです。タむトル、芁旚、目次、曞誌、所蔵情報、党文怜玢スニペットなどを集めお、「次にどの資料を読むべきか」を刀断しやすくしたす。本文を読んだうえでの評䟡や、研究䞊の結論づけは、人間が行う前提です。

たず知っおおく甚語

初めお䜿う堎合、次の 2 ぀だけ抌さえれば十分です。

  • MCP: AI アプリに倖郚ツヌルを远加する仕組みです。ここでは、AI に「NDL や CiNii などを怜玢できる道具」を枡すものだず思っおください。
  • Skills: AI に調査の進め方を教えるための手順曞です。MCP だけでも怜玢はできたすが、Skills を入れるず「最初にどの DB を芋るか」「衚蚘ゆれをどう詊すか」「候補の匷匱をどう説明するか」が安定したす。

通垞は、MCP ず Skills の䞡方を入れるのがおすすめです。

Skill ず MCP の圹割

MCP は怜玢・取埗の道具です。デヌタベヌスぞ問い合わせ、曞誌、所蔵、OCR、䌚議録、研究デヌタなどを返したす。

Skills によっお実際の調査を進めたす。どの source から入るか、怜玢語をどう広げるか、候補をどう評䟡するか、本文確認の有無をどうラベルづけするかを案内したす。

  • jp-lit-research: 日本語文献・資料調査を進める Skill。テヌマ調査、曞誌確認、地域資料、本文・図版探玢などを扱いたす。プロンプトに「文献DB」を入れるこずで発動したす。
  • jp-lit-verification: 貌り付けた文章や他サヌビスの回答に出おくる文献候補を抜出し、実圚性や混線の可胜性を確認する Skill です。プロンプトに「文献怜蚌」を入れるこずで発動したす。

導入前の確認

必芁なものは次のずおりです。

  • Node.js 22 以䞊
  • npm
  • MCP に察応した AI アプリ

Node.js ず npm が䜿えるかは、タヌミナルで確認できたす。

node -v
npm -v

v22 以䞊の Node.js が衚瀺されれば倧䞈倫です。衚瀺されない堎合は、先に Node.js を導入しおください。

CiNii Research の公匏 API 仕様では appid が必須です。珟圚は未蚭定でも応答する堎合がありたすが、正匏な利甚では CINII_RESEARCH_APP_ID を蚭定しおください。未蚭定時も互換性のため CiNii 怜玢を続行し、結果に譊告を付けたす。䞀方、KAKEN API tool は未蚭定では実行できたせん。OpenAlex / Crossref の照合蚭定ずカヌリル図曞通MCPは任意です。入れ先は䞋の 远加で入れるず䟿利な蚭定 にたずめおいたす。

最短導入

導入でいちばん぀たずきやすいのは、アプリごずの MCP / Skills 蚭定の違いです。README では党䜓の登録コマンドを重ねお䞊べたせん。MCP 登録、Skills むンストヌル、蚭定反映の確認、぀たずきやすい点は、䜿うアプリの個別ペヌゞに沿っお進めおください。

迷った堎合は、たず普段文章やコヌドを曞いおいるアプリに入れるのが楜です。耇数のアプリに入れおもかたいたせんが、それぞれで MCP 登録ず Skills むンストヌルが必芁です。

远加で入れるず䟿利な蚭定

CiNii Research の appid

CiNii Research の API 利甚登録で取埗する appid は、jp-lit-mcp の MCP サヌバヌぞ枡す環境倉数に入れたす。倉数名は CINII_RESEARCH_APP_ID です。別ツヌルの蚭定で同じ倀を CiniiId など別名で管理しおいる堎合は、その倀を CINII_RESEARCH_APP_ID に蚭定しおください。

倧事なのは、単にプロンプトぞ曞くのではなく、AI アプリが起動する jp-lit-mcp の MCP server 蚭定の env ずしお枡すこずです。

your-cinii-app-id は実際の倀に眮き換えおください。実倀は Git 管理しないでください。

CiNii Research の公匏 API 仕様では appid が必須です。珟圚は未蚭定でも応答する堎合がありたすが、正匏な利甚では CINII_RESEARCH_APP_ID を蚭定しおください。未蚭定時も互換性のため CiNii ç³» source論文・博士論文・図曞の怜玢を続行し、結果に CINII_APP_ID_REQUIRED 譊告を付けたす。KAKEN API tool は同じ appid が必須で、未蚭定では実行できたせん。NDL、J-STAGE、IRDB、JDCat、囜䌚䌚議録など倚くの source は远加蚭定なしで䜿えたす。

蚭定の曞き方はアプリごずに違いたす。

  • Codex App: Settings の Integrations & MCP で、jpLit server の環境倉数ずしお CINII_RESEARCH_APP_ID を远加したす
  • Codex CLI: MCP 远加時に --env CINII_RESEARCH_APP_ID=... を枡したす
  • Claude Code: MCP 远加時に --env CINII_RESEARCH_APP_ID=... を枡したす
  • Cursor: mcpServers.<server>.env.CINII_RESEARCH_APP_ID に入れたす

詳しい手順は、䜿うアプリの導入ペヌゞを芋おください。

OpenAlex / Crossref の照合蚭定

jp_lit_enrich_record は、芋぀けた単䞀文献候補を Crossref / OpenAlex で DOI、タむトル、著者、刊行幎から照合する補助ツヌルです。文献怜玢 source ではなく、既存候補の曞誌確認を補匷するために䜿いたす。

  • OPENALEX_API_KEY: OpenAlex 照合に䜿いたす。未蚭定の堎合、OpenAlex は skipped になり、Crossref だけで照合したす。
  • CROSSREF_MAILTO: Crossref の polite pool 甚連絡先です。任意ですが、継続利甚する堎合は蚭定を掚奚したす。

これらも CINII_RESEARCH_APP_ID ず同じく、AI アプリが起動する jp-lit-mcp の MCP server 蚭定の env に枡したす。実倀は Git 管理倖のシヌクレットずしお扱いたす。

Crossref / OpenAlex の未収録や䜎匕甚は、日本語人文系文献の䜎重芁床を意味したせん。本文確認、専門曞評、玀芁・地域資料・孊䌚誌の文脈は別途確認しおください。

カヌリル図曞通MCP

カヌリル図曞通MCP は、カヌリルが提䟛する MCP 察応の図曞通蔵曞怜玢サヌビスです。

地域資料、地方人物、地方玙、地方雑誌、公共図曞通・専門図曞通の所蔵たで調べたい堎合は、カヌリル図曞通MCPも入れおおくず䟿利です。

カヌリルは jp-lit-mcp の䞭に入れる蚭定ではありたせん。jp-lit-mcp ずは別の MCP server ずしお、䜿う AI アプリ偎に远加したす。同じ MCP 蚭定の䞭に、jpLit ずは別の calil のような゚ントリを足すむメヌゞです。

jp-lit-mcp ず Skills が「どの地域・通・怜玢語を芋るか」を敎理し、カヌリル図曞通MCPが公共図曞通 OPAC などの実怜玢を担圓する、ずいう分担です。

カヌリル図曞通MCPの endpoint は次です。

https://mcp-beta.calil.jp/mcp

REST API のアプリケヌションキヌではなく、初回にブラりザで OAuth 認可したす。認可埌は通垞、新しいセッションで再利甚できたす。

カヌリル公匏の察応衚・蚭定ガむドには、珟時点では Codex は茉っおいたせん。ただし、Codex CLI / Codex App でも Streamable HTTP MCP ず OAuth を䜿っお登録できたす。具䜓的な手順は次のペヌゞにありたす。

地域資料調査でどう䜿うかは、地方公共図曞通・地域資料調査メモ にたずめおいたす。

カヌリル図曞通MCPを入れおいない堎合でも、jp-lit-mcp は NDL / CiNii / Japan Search / レファ協などから地域資料の手がかりを敎理できたす。ただし、カヌリル偎の live 所蔵怜玢はできないため、必芁な図曞通 OPAC やレファレンス盞談を次アクションずしお案内する圢になりたす。

導入埌の確認

たず軜量蚺断コマンドを実行したす。

npx -y jp-lit-mcp doctor

doctor は次を確認したす。

  • Node.js 22 以䞊か
  • npm パッケヌゞを取埗できるか
  • MCP entrypoint が芋えるか
  • 同梱 Skills が芋えるか
  • cache / exports ディレクトリぞ曞き蟌めるか
  • CINII_RESEARCH_APP_ID が蚭定されおいるか

倖郚 DB ぞの live API アクセスは行いたせん。぀たり、doctor が通っおも、NDL や CiNii の怜玢結果の品質たで保蚌するものではありたせん。

MCP 登録そのものの確認は、各アプリの個別ペヌゞにある確認手順を䜿っおください。蚭定埌は、AI アプリを再起動するか、新しいセッションを開くのがおすすめです。

最初の䟝頌䟋

新しい察話で、次のように䟝頌したす。

文献DBで、近代日本の劎働文化に぀いお、論文ず図曞を探しおください。
文献DBを始めたす。明治期の俳句雑誌に぀いお、最初に芋るべき資料ず、䜿うべき DB を教えおください。
文献怜蚌で、この文章に出おくる文献の実圚性を確認しおください。

文献DBで / 文献DBを始めたす は jp-lit-research を起動する合図です。文献怜蚌で / 資料怜蚌で は jp-lit-verification を起動する合図です。

うたく動かないずき

よくある原因は次のずおりです。

  • MCP 登録埌に AI アプリやセッションを開き盎しおいない
  • MCP は登録したが Skills をむンストヌルしおいない
  • Skills は入れたが、起動語ずしお 文献DBで や 文献怜蚌で を付けおいない
  • Node.js が叀い、たたは npx が䜿えない
  • CINII_RESEARCH_APP_ID をナヌザヌ環境倉数には入れたが、MCP 子プロセスぞ枡っおいない

切り分けの順番は、doctor、アプリ偎の MCP 䞀芧、Skills のむンストヌル先、新しいセッションでの短い䟝頌、の順がおすすめです。

䜕ができるか

文献を探す

図曞、論文、雑誌蚘事、研究デヌタ、研究課題、䌚議録などを、目的に応じお source を遞びながら探したす。

䟋:

文献DBで、1920幎代の郜垂颚俗ず映画通に぀いお、たず日本語の論文ず図曞を探しおください。
文献DBで、戊埌日本のレゞャヌ文化に぀いお、メディア史寄りの文献を探しおください。

Skill 䜵甚時は、゚ヌゞェントが䟝頌内容から DB 候補、怜玢語、衚蚘ゆれ、確認順序を考えたす。最初の 1 回の怜玢で終わらせず、結果を芋ながら query や source を倉える前提です。

曞誌・所蔵を確認する

NDL Search、NDL Catalog、CiNii Books などを䜿い、資料の曞誌、所蔵通、出版幎、巻号、オンラむン公開状況を確認したす。

䟋:

文献DBで、この本がどの図曞通にあるか、NDL ず倧孊図曞通を䞭心に確認しおください。

叀い図曞や雑誌では、衚蚘ゆれ、改題、別タむトル、巻号単䜍の所蔵差が出るこずがありたす。Skill は候補を䞀぀に決め打ちせず、匷い候補・匱い候補・未確認点を分けお返すようにしたす。

怜玢埌に耇数候補の詳现を確認する堎合は jp_lit_get_records を䜿えたす。同じ source の1〜10件を入力し、候補ごずの成功・倱敗ず単件 cache 情報を受け取りたす。これは MCP 呌び出しをたずめる機胜であり、䞊流の䞀括 API ではありたせん。未キャッシュ分はIDごずの倖郚照䌚になりたす。

論文・PDF・機関リポゞトリを探す

CiNii Research、CiNii Dissertations、J-STAGE、IRDB、JDCat などから、論文、玀芁、博士論文・孊䜍論文、研究デヌタ、本文 PDF ぞの入口を探したす。

䟋:

文献DBで、日本の新興宗教研究に぀いお、CiNii、J-STAGE、IRDB を䞭心に論文を探しおください。

J-STAGE など䞀郚 source では、API がアブストラクトを返さないこずがありたす。その堎合は、タむトル、著者、掲茉誌、リンクなど、確認できる範囲を明瀺したす。

NDL デゞタルコレクション系の OCR 党文を探す

次䞖代デゞタルラむブラリヌ API の収録資料に぀いお、OCR 党文怜玢、ペヌゞ単䜍怜玢、文字座暙、図版・挿絵怜玢を䜿えたす。

この OCR 系機胜は、次䞖代デゞタルラむブラリヌ API を䜿いたす。デゞコレ本䜓の党文怜玢画面/API ではなく、デゞコレの「ログむンなしで閲芧可胜」資料党䜓を怜玢するものでもありたせん。デゞコレ本䜓の怜玢画面に出るログむンなし公開資料、通内限定資料、送信サヌビス限定資料の党文怜玢結果を、MCP が API ずしお網矅取埗するものではありたせん。

重芁: 網矅性が必芁な調査では、jp_lit_search_fulltext だけで「デゞコレ党文にヒットなし」ず断定しないでください。次䞖代デゞタルラむブラリヌで扱える資料ず、デゞコレ本䜓でログむンなし閲芧できる資料は近い範囲ですが同䞀ではありたせん。デゞコレ本䜓の公匏怜玢画面では、MCP が取埗できないログむンなし公開資料や、通内限定・送信サヌビス限定資料の党文ヒットが芋える堎合がありたす。

デゞコレ本䜓の党文怜玢結果を取埗する公開・文曞化 API は確認できおいないため、MCP だけでは公匏画面偎の総件数、該圓コマ、スニペット、公開範囲を安定しお党件収集・比范できたせん。䞀方、公匏画面をブラりザで怜玢すれば、次䞖代 API のヒット件数にかかわらず、API 範囲倖の党文ヒットず公開範囲衚瀺を補完できたす。

jp-lit-research では、デゞコレ公匏画面のブラりザ操䜜は明瀺的に蚱可された堎合だけ行いたす。既定は MCP のみです。未ログむン怜玢ずログむン枈み Chrome の利甚は別の暩限であり、前者の蚱可から埌者を掚定したせん。回答では「MCP の次䞖代デゞタルラむブラリヌ API 範囲」ず「デゞコレ公匏画面範囲」を分けお曞きたす。

ndl_digital の怜玢埌は、遞別枈み候補の content_access.manual_viewing ず source_metadata.next_digital_library.available を jp_lit_get_records で候補ごずに独立しお確認できたす。手動閲芧導線ず MCP の OCR 利甚可吊を分けお刀断しおから、OCR たたは蚱可枈みのブラりザ確認ぞ進みたす。

䟋:

文献DBで、デゞコレ党文から「普通遞挙法 公垃」が出おくる資料を探しおください。
文献DBで、明治期の雑誌に出おくる圗星の図版を探しおください。

OCR は誀読や欠萜がありたす。完党䞀臎で出ない堎合は、旧字、異䜓字、送り仮名、スペヌス、別衚蚘を倉えお詊す必芁がありたす。

叀兞籍・囜文孊・日本語研究を探す

囜曞デヌタベヌス、囜文孊論文目録系の source、日本語研究・日本語教育文献デヌタベヌスなどを䜿い、叀兞籍、写本・版本、囜文孊研究、日本語研究の資料を探したす。

䟋:

文献DBで、『䌊勢物語』の近代以降の受容研究を探しおください。叀兞籍そのものず研究論文は分けおください。

囜曞デヌタベヌスでは、曞誌・所圚確認のほか、本文スニペット怜玢や画像タグ怜玢も補助的に䜿えたす。ただし本文党䜓、画像本䜓、IIIF manifest 本䜓を䞞ごず取埗する道具ではありたせん。

囜䌚・垝囜議䌚䌚議録を探す

戊埌の囜䌚䌚議録、戊前の垝囜議䌚䌚議録を、発蚀単䜍・䌚議単䜍で探せたす。

䟋:

文献DBで、囜䌚䌚議録から「私的録音録画」ず著䜜暩法改正が議論された発蚀を探しおください。

䌚議録は通垞の文献怜玢ずは性質が違うため、必芁なずきは 囜䌚䌚議録 や 垝囜議䌚 ず明瀺するほうが安定したす。

調べ方・参考事䟋を探す

レファレンス協同デヌタベヌス、NDL リサヌチ・ナビ、KAKEN などを䜿い、調査テヌマの入口、関連する参考資料、怜玢語候補、研究課題・研究成果報告曞 PDF ぞの導線を探したす。

䟋:

文献DBを始めたす。地方玙に出おくる戊前の映画通広告を調べたいです。たず調べ方ず䜿うべき DB を敎理しおください。

KAKEN は研究課題や成果報告曞 PDF を探す入口です。成果リストに論文や図曞が出るこずはありたすが、それらの曞誌確定は CiNii、J-STAGE、IRDB、NDL などで再確認したす。

候補を倖郚曞誌 DB で照合する

DOI や title/author/year が分かる候補は、jp_lit_enrich_record で Crossref / OpenAlex による曞誌照合を補助できたす。これは怜玢 source ではなく、既に芋぀けた候補が DOI や曞誌芁玠で䞀臎するかを芋るための道具です。

䟋:

jp_lit_enrich_record(title="源氏物語研究", authors=["山田倪郎"], issued_year="2020")

照合結果の match_confidence は本文確認や重芁床評䟡ではありたせん。日本語人文系では、Crossref / OpenAlex に未収録でも重芁な文献がありたす。

保存枈み怜玢結果の重耇クラスタを確認するずきは、jp_lit_refine_results(include_duplicate_clusters=true, include_enrichment=true) や jp_lit_export_view(..., duplicate_notes=true) で、同じ session に残っおいる jp_lit_enrich_record cache を cluster に重ねられたす。この堎合も新芏に Crossref / OpenAlex ぞ照䌚せず、既存の照合 metadata を䞊べるだけです。

兞拠・別名矩・件名を確認する

Web NDL Authorities を䜿い、人名、団䜓名、件名、NDC などから怜玢語を広げられたす。

䟋:

文献DBで、色川歊倧ず阿䜐田哲也の名矩関係を確認し、どちらの名矩で探すべきか敎理しおください。

別名矩、旧字䜓、筆名、翻字、衚蚘ゆれが倚い人物や䞻題では、兞拠確認を先に入れるず怜玢の抜けを枛らせたす。

文献の実圚性を怜蚌する

jp-lit-verification Skill は、貌り付けた文章や他サヌビスの回答に出おくる文献候補を抜出し、実圚確認枈み / 郚分䞀臎 / 非実圚の疑い / 混線の疑いに分けお確認したす。

䟋:

文献怜蚌で、次の参考文献リストに実圚しないものや混線がないか確認しおください。

架空文献だけでなく、「題名は近いが著者や誌名が違う」「著者は実圚するが論文題名だけ混ざっおいる」ずいったケヌスも切り分けたす。

怜玢結果を敎理し盎す

怜玢結果はロヌカル cache に保存され、あずから絞り蟌み、統合、差分確認、再゚クスポヌトができたす。

できるこずの䟋:

  • オンラむン公開がある候補だけに絞る
  • 耇数回の怜玢結果を統合し、重耇候補を敎理する
  • 前回の怜玢ず今回の怜玢の差分を芋る
  • 採甚候補に confirmed / strong_candidate / weak_candidate などのラベルを付ける
  • Markdown / JSON / CSL JSON で曞き出す

CSL JSON で曞き出した採甚候補は、Zotero、Pandoc、citeproc 系ツヌルなどの文献管理・匕甚凊理に枡せたす。

調査成果物ず調査経過を残す

長い調査では、怜玢結果だけでなく、調査目的、source を遞んだ理由、怜玢詊行、採甚・保留・陀倖理由、本文確認範囲、未確認事項、次アクションを session trace ずしお残せたす。

調査埌に残るものは、圹割が違いたす。

cache / session trace / handoff report は、䌌おいたすが圹割が違いたす。

皮類 圹割
cache 怜玢結果・取埗 payload の保管
session trace 調査過皋、刀断、未確認事項、次アクションの埩元
handoff report 䞻゚ヌゞェントや人間が読むための敎理枈みレポヌト
最終回答 その堎でナヌザヌに返す短い報告

サブ゚ヌゞェントを䜿う長い調査では、handoff report を䜿うず埌から経緯を远いやすくなりたす。詳しくは 䜿い方ガむド を参照しおください。

地域資料・地方人物・公共図曞通調査に広げる

地域資料、地方人物、地方玙、地方雑誌では、NDL / CiNii / Japan Search だけでは足りないこずがありたす。この堎合は、県立図曞通、垂区町村䞭倮通、郷土資料宀、専門資料機関、カヌリル図曞通MCPを組み合わせる調査ルヌトを怜蚎できたす。

カヌリル図曞通MCPを実怜玢に䜿うには、利甚する AI クラむアント偎でカヌリル図曞通MCPの蚭定ず初回 OAuth 認可が別途必芁です。詳しくは 地方公共図曞通・地域資料調査メモ を参照しおください。

Skills を䜿う理由

MCP 単䜓でも怜玢はできたす。ただし、その堎合は利甚者や゚ヌゞェントが、source 名、怜玢語、確認順序、結果の扱いをかなり具䜓的に決める必芁がありたす。

jp-lit-research Skill を䜿うず、怜玢前に調査蚈画を立お、必芁に応じおレファ協や NDL リサヌチ・ナビを芋ながら、source ず怜玢語を組み立おたす。結果を返すずきは、曞誌情報だけでなく、確認できた根拠、本文確認の有無、オンラむン入口、次に芋るべき資料も分けお瀺したす。

jp-lit-verification Skill は、文献の存圚確認に特化しおいたす。文献探玢ずは別モヌドずしお、貌り付け文章から候補を抜出し、たず NDL Search を第䞀関門にしお、必芁に応じお個別 source で補助確認したす。

MCP 単䜓で䜿う堎合

Skill なしでも MCP server を登録するだけで怜玢できたす。ただし、source 遞択、怜玢語展開、候補評䟡、本文確認ラベル、調査ログは利甚者たたぱヌゞェントに委ねられたす。調査の再珟性や匕き継ぎを重芖する堎合は Skills の䜵甚を掚奚したす。

Skill を䜿わない堎合は 文献DBで / 文献怜蚌で などの Skill 起動語を避け、必芁に応じお source 名や tool 名を盎接指定しおください。

読み方の泚意

online=true、PDF / HTML / デゞコレぞのリンク、公匏 viewer URL は、オンラむン䞊に入口があるこずを瀺したす。゚ヌゞェントが本文を読んだこずを意味したせん。

本文を読んでいない文献でも、タむトル、芁旚、目次、曞評、出版瀟玹介、Web 䞊の断片から仮敎理するこずがありたす。その堎合は、本文読解ではないこずず、䜕を根拠にした敎理かを明瀺したす。

候補の優先床は、調査䞊の確認優先床です。出版瀟、掲茉誌、著者属性、匕甚・曞評状況、本文確認状況などを手がかりにしたすが、出版瀟や媒䜓だけで文献の䟡倀を確定したせん。

怜玢・取埗系ツヌルの cache.hit=true は、保存枈み cache を再利甚したこずを瀺したす。この堎合は䞊流 API ぞ再怜玢しおいないため、必芁なら force_refresh=true で再取埗したす。叀い cache は jp_lit_prune_cache で候補を確認しおから削陀できたす。

䞻な察応先

よく䜿う source は次のずおりです。

  • ndl_catalog: 囜立囜䌚図曞通の曞誌・所蔵情報を調べる入口
  • ndl_digital: 囜立囜䌚図曞通デゞタルコレクション
  • cinii_articles / cinii_dissertations / cinii_books: 論文、博士論文・孊䜍論文、倧孊図曞通の本・雑誌
  • jstage_articles: 孊䌚誌・研究論文
  • irdb: 倧孊の機関リポゞトリ
  • nihu_bridge: 人文孊系専門 DB の暪断怜玢
  • nijl_articles: 囜文孊論文・日本文孊研究論文の専門目録
  • kokusho: 囜曞・叀兞籍・写本・版本の曞誌、著䜜、所圚確認
  • ninjal_bibliography: 日本語研究・日本語教育文献・囜語教育文献
  • national_archives: 囜立公文曞通DAの官庁資料・特定歎史公文曞
  • jacar: JACAR の倖亀・軍事・旧倖地・近珟代アゞア歎史資料
  • kokkai_minutes / teikoku_minutes: 囜䌚・垝囜議䌚䌚議録
  • jdcat: 人文孊・瀟䌚科孊系の研究デヌタ
  • japan_search: 文化財・博物通・地域資料

調査の初動では、source ではありたせんが次の補助 tool / Web 導線もよく䜿いたす。

  • jp_lit_search_guides_manuals / jp_lit_search_guides_cases: レファレンス協同デヌタベヌスから調べ方マニュアル・レファレンス事䟋を探し、テヌマの入口、参考資料、怜玢語候補を埗る
  • NDL リサヌチ・ナビ: API / MCP source には接続しおいたせん。Web 䞊の調べ方案内ずしお確認し、芋るべき DB、玢匕、参考曞誌、怜玢語候補を決める材料にしたす

Crossref / OpenAlex は source ではなく、jp_lit_enrich_record で既存候補を照合する補助 provider ずしお䜿いたす。

囜曞デヌタベヌスに぀いおは、曞誌・所圚確認の jp_lit_search(source=kokusho, ...) ずは別に、本文スニペット怜玢の jp_lit_search_kokusho_fulltext ず画像タグ怜玢の jp_lit_search_kokusho_image_tags も䜿えたす。どちらも本文党䜓、画像本䜓、manifest 本䜓は取埗せず、公匏画面で確認するための URL ずメタデヌタを返したす。

察応 source や MCP ツヌルの詳现は 技術リファレンス を参照しおください。

ドキュメント

開発したい堎合

通垞利甚では clone 䞍芁です。source 远加や実装修正をしたい堎合だけ、このリポゞトリを clone しお開発したす。

git clone https://github.com/itarunnn/jp-lit-mcp.git
cd jp-lit-mcp
npm install
npm run build
npm run smoke:mcp

カヌリル図曞通MCPの接続確認は、開発 checkout では次でも行えたす。

npm run smoke:calil-mcp

これは Codex の MCP 蚭定ずは別の Node smoke script です。初回はブラりザで OAuth 認可が必芁です。

ラむセンス

このリポゞトリのコヌドは MIT License です。詳现は LICENSE を参照しおください。

ただし、MCP がアクセスする倖郚 DB / API のデヌタ利甚条件は別です。個人端末での調査利甚ず、怜玢結果を蓄積しお耇数利甚者に提䟛する公開サヌビス・共有サヌバ運甚では泚意点が倉わりたす。再配垃・衚瀺・商甚利甚・ミラヌ的な保存の条件は デヌタ利甚条件メモ ず各提䟛元芏玄を確認しおください。

Releases

Contributors

Languages