kaken-mcp

科研費データベース KAKEN で採択課題や研究者を探せます。課題番号が分かっているときは、その番号から研究機関、研究期間、実施状況を確認できます。

利用前に

uv と Git が必要です。Python 3.12以上に対応しています。NIIのAPI利用登録で発行されたアプリケーションIDが必要です。CiNii Web APIのIDを取得済みなら同じIDを使えます。下の例の YOUR_KAKEN_APP_ID を手元の設定で差し替えてください。

Related MCP server: CiNii MCP Server

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

公開GitHubリポジトリから uvx で起動します。初回は依存関係の準備に時間がかかることがあります。

Codex

codex mcp add kaken-mcp --env "KAKEN_APP_ID=YOUR_KAKEN_APP_ID" -- uvx --python 3.12 --from git+https://github.com/koizumikento/kaken-mcp.git@main kaken-mcp
codex mcp list

新しいセッションで /mcp を開くと、接続を確認できます。デスクトップ版では設定の「MCP servers」で、下のJSON例と同じコマンド・引数・環境変数を指定できます。Codexの公式設定ガイド

Claude Desktop / Cursor

• Claude Desktop（Windows） %APPDATA%/Claude/claude_desktop_config.json

• Claude Desktop（macOS） ~/Library/Application Support/Claude/claude_desktop_config.json

• Cursor .cursor/mcp.json（プロジェクト内）

設定ファイルの mcpServers に項目を追加して、クライアントを再起動してください。uvx が見つからない場合は、実行ファイルの絶対パスを指定します。

{
  "mcpServers": {
    "kaken-mcp": {
      "command": "uvx",
      "args": ["--python", "3.12", "--from", "git+https://github.com/koizumikento/kaken-mcp.git@main", "kaken-mcp"],
      "env": {"KAKEN_APP_ID": "YOUR_KAKEN_APP_ID"}
    }
  }
}

登録後の質問例

科研費の採択課題から、都市のヒートアイランドに関する研究を5件探して。気になる課題は番号から研究期間と実施状況も調べて。

MCPツール

検索は1〜20件ずつ取得でき、続きは返された next_start を start に指定します。課題番号の照会では、該当するレコードを items に返します。照会した範囲で完全一致がなければ空になります。

CLIで使う

CLIやPythonを実行するシェルで環境変数を設定します。

$env:KAKEN_APP_ID = "YOUR_KAKEN_APP_ID"

macOSやLinuxのシェルでは export KAKEN_APP_ID="YOUR_KAKEN_APP_ID" を使います。

結果は標準出力にUTF-8のJSONで返ります。

uvx --python 3.12 --from git+https://github.com/koizumikento/kaken-mcp.git@main kaken-mcp search-projects --query "ヒートアイランド" --limit 5
uvx --python 3.12 --from git+https://github.com/koizumikento/kaken-mcp.git@main kaken-mcp get-project --project-number 21K00001
uvx --python 3.12 --from git+https://github.com/koizumikento/kaken-mcp.git@main kaken-mcp search-researchers --name "横山 幹子" --affiliation "筑波大学"

Pythonから呼び出す

git clone https://github.com/koizumikento/kaken-mcp.git
cd kaken-mcp
uv sync --locked

import asyncio

from kaken_mcp import get_project

result = asyncio.run(get_project("21K00001"))
print(result)

すでにイベントループがある場合は、関数を直接 await してください。

出典と利用条件

コードはMIT Licenseです。国立情報学研究所の科研費データベース KAKEN のOpenSearch APIを使用します。NIIのAPI利用細則では、自己の学術研究・非営利の情報利活用以外の目的には事前の申請と承認が必要です。取得した情報を利用する際は出典を記載してください。公式API仕様 · KAKEN 利用規程 · NII ウェブAPI利用細則

開発

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