CiNii MCP Server

Setup

uv sync --no-dev

Please set the directory path and the CINII_APP_ID.

{
  "mcpServers": {
    "cinii-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "<YOUR_MCP_SERVER_DIRECTORY>",
        "run",
        "server.py"
      ],
      "env": {
        "CINII_APP_ID": "<YOUR_CINII_APP_ID>"
      },
    }
  }
}

API Key Registration

1. Access CiNii API Registration
2. Find and access the link for "CiNii Web API Developer Registration".
3. Upon accessing, a registration form will appear. Fill in the necessary information and submit your application.
4. After submission, your Application ID will be sent to you via email.

Usage

Python API

from lib.cinii import CiNiiClient, SortOrder, SearchRange

client = CiNiiClient(appid="your_app_id")

# Basic search
results = client.advanced_search({
    "query": "機械学習",
    "max_results":  10
})

# Advanced search with filters
results = client.advanced_search({
    "query": "Deep Learning",
    "max_results": 20,
    "sortorder": SortOrder.PUBLICATION_YEAR_DESC,  # Publication year, descending
    "range": SearchRange.HAS_BODY_IN_CINII,        # The full text is available on CiNii.
    "year_from": 2020,
    "year_to": 2024
})

# Or you can also use numeric values for the search Options
results = client.advanced_search({
    "query": "Deep Learning",
    "max_results": 20,
    "sortorder": 1,  # Publication year, descending
    "range": 1,      # The full text is available on CiNii.
    "year_from": 2020,
    "year_to": 2024
})

Sort Order Options

• SortOrder.PUBLICATION_YEAR_DESC (1): Publication year descending
• SortOrder.PUBLICATION_YEAR_ASC (2): Publication year ascending
• SortOrder.TITLE_DESC (3): Title descending
• SortOrder.TITLE_ASC (4): Title ascending
• SortOrder.JOURNAL_DESC (5): Journal descending
• SortOrder.JOURNAL_ASC (6): Journal ascending
• SortOrder.CITATION_DESC (7): Citation count descending

Search Range Options

• SearchRange.ALL (0): All
• SearchRange.HAS_BODY_IN_CINII (1): Body exists in CiNii
• SearchRange.HAS_BODY_OR_LINK (2): Body exists in CiNii, or link exists in linked services