Skip to main content
Glama
mcp-cinii

mcp-cinii

by iwaokimura

mcp-cinii

MCP for CINII API

An MCP server that exposes CiNii Research search capabilities to LLM clients such as Claude Code.

Tools

search_cinii

Search CiNii Research for academic articles, books, grants, and research data.

Parameter

Type

Default

Description

query

string

—

Search keywords (e.g. "機械学習" or "machine learning")

count

int

20

Number of results (1–200)

start

int

1

1-based offset for pagination

lang

string

"ja"

Response language: "ja" or "en"

resource_type

string

""

Filter: "Article", "Book", "Dissertation", "Data", "Research Project", or "" (all)

Returns CiNii Research JSON-LD response.

get_cinii_item

Retrieve metadata for a single CiNii Research item by its ID.

Parameter

Type

Default

Description

item_id

string

—

CiNii Research CRID from the item URL (e.g. "1971993809790115224")

lang

string

"ja"

Response language: "ja" or "en"

Returns JSON-LD metadata for the item.

Related MCP server: cinii-mcp

Installation

pip install mcp-cinii

Configuration

CiNii Research's OpenSearch API requires an application ID (appid). Register as a developer and obtain one at CiNii - API User Registration, then set it via the CINII_APP_ID environment variable. If unset, requests are sent without appid (may be subject to stricter rate limits).

Usage with Claude Code

claude mcp add --transport stdio cinii -e CINII_APP_ID=<your-appid> -- mcp-cinii

Development

uv sync --group dev
uv run pytest

Available Tools

2 tools
get_cinii_itemA

Retrieve metadata for a single CiNii Research item by its ID.

Args: item_id: The CiNii Research CRID, e.g. "1971993809790115224". This is the numeric part that appears after "https://cir.nii.ac.jp/crid/" in the item URL. lang: Response language, "ja" (Japanese) or "en" (English). Default "ja".

Returns: JSON-LD metadata for the item as a formatted JSON string.

Inputs: item_id (required), lang. Returns: result

search_ciniiA

Search CiNii Research for academic articles, books, grants, and data.

Args: query: Search keywords (e.g. "機械学習" or "machine learning"). count: Number of results to return (1–200, default 20). start: 1-based result offset for pagination (default 1). lang: Response language, "ja" (Japanese) or "en" (English). Default "ja". resource_type: Filter by resource type. One of "Article", "Book", "Dissertation", "Data", "Research Project", or "" (all types).

Returns: JSON-LD response from CiNii Research as a formatted JSON string.

Inputs: query (required), lang, count, start, +1 more. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    get_cinii_item retrieves a single item by ID, while search_cinii performs keyword-based searches with filters. These are clearly distinct operations with no overlap.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern (get_cinii_item, search_cinii) using snake_case, with 'cinii' as the common domain prefix.

    Tool Count5/5

    Two tools is appropriate for a focused academic search and retrieval server. It covers the essential operations without being too few or too many.

    Completeness4/5

    The tool set covers search with filtering and per-item retrieval. Minor gaps include lack of browse or citation export, but core functionality for accessing CiNii Research is well-covered.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables searching and retrieving academic articles from CiNii, Japan's largest bibliographic database, with support for advanced filtering, sorting, and search range options.
      1
      1
      Apache 2.0
    • 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables searching academic papers, journals, and citations via the Crossref API, and resolving DOIs to canonical metadata with authors, references, and citation graphs.
      114 npm
      MIT