mcp-cinii
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-cinii Search for articles about machine learning in Japanese"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| string | — | Search keywords (e.g. |
| int | 20 | Number of results (1–200) |
| int | 1 | 1-based offset for pagination |
| string |
| Response language: |
| string |
| Filter: |
Returns CiNii Research JSON-LD response.
get_cinii_item
Retrieve metadata for a single CiNii Research item by its ID.
Parameter | Type | Default | Description |
| string | — | CiNii Research CRID from the item URL (e.g. |
| string |
| Response language: |
Returns JSON-LD metadata for the item.
Related MCP server: cinii-mcp
Installation
pip install mcp-ciniiConfiguration
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-ciniiDevelopment
uv sync --group dev
uv run pytestAvailable Tools
2 toolsget_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
Scored across 2 tools
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.
Both tools follow a consistent verb_noun pattern (get_cinii_item, search_cinii) using snake_case, with 'cinii' as the common domain prefix.
Two tools is appropriate for a focused academic search and retrieval server. It covers the essential operations without being too few or too many.
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
Related MCP Connectors
Search 150M+ academic works, journals, and funders via Crossref API.
Search 250M+ academic works, citation graphs, DOIs, and institutional research via OpenAlex.
Scholarly search: OpenAlex, Crossref, arXiv, OpenCitations and PubMed in one endpoint.
Search DataCite datasets and software, fetch DOI metadata, trace relations, format citations.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables searching and retrieving academic articles from CiNii, Japan's largest bibliographic database, with support for advanced filtering, sorting, and search range options.11Apache 2.0
- AlicenseAqualityBmaintenanceEnables querying Japan's national academic database, CiNii Research, for articles, books, dissertations, KAKEN projects, and researcher profiles via seven MCP tools.113MIT
- FlicenseAqualityDmaintenanceEnables to search academic papers in Japanese and English, inspect availability of full text, and download public PDFs locally.4-
- AlicenseNot gradedqualityBmaintenanceEnables searching academic papers, journals, and citations via the Crossref API, and resolving DOIs to canonical metadata with authors, references, and citation graphs.114 npmMIT