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.

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