Skip to main content
Glama
Sign In
jp-cultural-data-mcp

jp-cultural-data-mcp

by koizumikento
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

jp-cultural-data-mcp

国立国会図書館、ジャパンサーチ、メディア芸術データベースの資料を調べるMCPサーバーです。MCP、CLI、Pythonライブラリから同じ機能を使えます。

準備 · MCP登録 · CLI · Python · 移行手順

準備

Python 3.12以上、uv、Gitが必要です。

git clone https://github.com/koizumikento/jp-cultural-data-mcp.git
cd jp-cultural-data-mcp
uv sync --locked

APIキーは不要です。

Related MCP server: @cyanheads/datacite-mcp-server

MCPクライアントに登録する

設定例の /absolute/path/to/jp-cultural-data-mcp をクローン先の絶対パスに置き換えます。Windowsでは C:/projects/jp-cultural-data-mcp のように書けます。

Codex

codex mcp add jp-cultural-data-mcp -- uv --directory "/absolute/path/to/jp-cultural-data-mcp" run --locked jp-cultural-data-mcp
codex mcp list

新しいセッションで /mcp を開いて接続状態を確認します。

Claude Desktop / Cursor

Claude DesktopはOSに応じて次のファイルに設定します。

  • Windowsは %APPDATA%/Claude/claude_desktop_config.json

  • macOSは ~/Library/Application Support/Claude/claude_desktop_config.json

Cursorはプロジェクト内の .cursor/mcp.json を使います。mcpServers に次の項目を追加し、クライアントを再起動してください。

{
  "mcpServers": {
    "jp-cultural-data-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/jp-cultural-data-mcp",
        "run",
        "--locked",
        "jp-cultural-data-mcp"
      ]
    }
  }
}

uv が見つからない場合は、command に実行ファイルの絶対パスを指定してください。

ツール

データごとの入力条件、結果、出典と利用条件は、表のリンク先に記載しています。

ツール

データと操作の説明

search_bibliography

国立国会図書館

get_digitized_pages

国立国会図書館

search_items

ジャパンサーチ

get_item

ジャパンサーチ

search_collections

ジャパンサーチ

get_manga_issue_contents

メディア芸術データベース

search_manga_issues

メディア芸術データベース

search_works

メディア芸術データベース

CLIで使う

クローン先で実行します。取得結果はUTF-8のJSONとして標準出力に書き出します。

uv run jp-cultural-data-mcp ndl search-bibliography --title 源氏物語 --limit 3
uv run jp-cultural-data-mcp japan-search search-items --query モネ --limit 3
uv run jp-cultural-data-mcp mediaarts get-manga-issue-contents --query 週刊少年マガジン --limit 3

引数の説明は、各サブコマンドに --help を付けて確認できます。

Pythonで使う

自分のPythonプロジェクトの依存関係に追加します。

uv add "git+https://github.com/koizumikento/jp-cultural-data-mcp.git@main"

次のコードを example.py に保存し、uv run python example.py で実行します。

import asyncio

from jp_cultural_data_mcp import search_bibliography

result = asyncio.run(search_bibliography(title="源氏物語", limit=3))
print(result)

ツールと同じ名前の非同期関数を利用できます。すでにイベントループがある場合は、直接 await してください。

出典と利用条件

コードはMITライセンスです。データは実行時に各提供元から取得します。取得データには、データ別の説明に記載した提供元の利用条件が適用されます。

開発

uv sync --locked
uv run ruff check .
uv run ty check
uv run pytest
uv build

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • cinii-mcp

      ckgerteis
      A
      license
      A
      quality
      B
      maintenance
      Enables querying Japan's national academic database, CiNii Research, for articles, books, dissertations, KAKEN projects, and researcher profiles via seven MCP tools.
      11
      3
      MIT

    • japan-search-mcp

      koizumikento
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables keyword cross-searching of Japan Search cultural collections and retrieval of item metadata by ID through a read-only MCP interface.
      MIT

    • nii-research-mcp

      koizumikento
      A
      license
      B
      quality
      C
      maintenance
      Enables users to search CiNii Research articles and research records plus KAKEN projects and researcher information through MCP, CLI, and Python interfaces.
      6
      MIT