Skip to main content
Glama
kaken-mcp-server

kaken-mcp-server

by masa-med-ai

kaken-mcp-server

科学研究費助成事業データベース(KAKEN)の公式 OpenSearch API を Claude から利用するためのローカル MCP サーバ。claude_desktop_config.json の env 経由で KAKEN_APPID を渡せるため、Win/Mac の Claude Desktop で確実に動作する。

提供ツール:

ツール名

用途

kaken_search_projects

研究課題を多条件で検索(kw/qa/qb/qg/qh/qm/qc/qd/qe/qf/s1/s2/o1/od)

kaken_search_researchers

研究者を検索(kw/qg/qm/qh/qq/qs/qe/qd)

kaken_get_project

課題番号から1件の詳細取得

kaken_get_researcher_grants

研究者番号から関与全課題を取得(業績把握用)

0. インストール方法(3通り)

すべての方法で、先に CiNii API 利用登録 でアプリケーションID(appid)を取得しておくこと。

A. Claude Desktop 拡張機能(.mcpb バンドル)— 推奨

Releases から kaken-mcp-server-x.y.z.mcpb をダウンロードし、ダブルクリック(または Claude Desktop の 設定 → 拡張機能 にドラッグ&ドロップ)。インストールダイアログで appid を入力するだけで使える。Node.js のインストールも不要(Claude Desktop 内蔵ランタイムで動作)。

.mcpb を自分でビルドする場合:

npm install
npm run build                 # tsc → dist/
node scripts/build-mcpb.mjs   # kaken-mcp-server-x.y.z.mcpb を生成

Note: npx @anthropic-ai/mcpb pack は使わない。新しい mcpb CLI が生成する zip (ディレクトリエントリ無し・小構成)だと Claude Desktop のインストーラが "reply was never sent" で無応答になる。scripts/build-mcpb.mjs はインストール 実績のある形式(dist + production node_modules 同梱、dir エントリ + unix ファイル種別ビット付き zip)で生成する。 なお npm run bundle(esbuild 単一ファイル server/index.cjs)は Claude Code プラグイン用で、.mcpb には使わない。

B. Claude Code プラグイン(マーケットプレイス経由)

/plugin marketplace add masa-med-ai/kaken-mcp-server
/plugin install kaken-search@kaken-marketplace

appid は環境変数で渡す(シェルの rc ファイル等に設定):

export KAKEN_APPID="YOUR_APPID_HERE"

C. 手動セットアップ(claude_desktop_config.json)

以下の手順1〜3を参照。

Related MCP server: jgrants-mcp-server

1. 手動セットアップ

1-1. appid を取得

CiNii API 利用登録 でアプリケーションID(appid)を取得する。

1-2. このリポジトリを準備

git clone <this-repo>  # または手動配置
cd kaken-mcp-server
npm install
npm run build

dist/index.js が生成される。

1-3. claude_desktop_config.json に登録

設定ファイルの場所:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

以下を追記する(既存の mcpServers がある場合はその中にマージ):

{
  "mcpServers": {
    "kaken": {
      "command": "node",
      "args": ["/絶対パス/kaken-mcp-server/dist/index.js"],
      "env": {
        "KAKEN_APPID": "YOUR_APPID_HERE"
      }
    }
  }
}

Windows の例(パス区切りに注意。バックスラッシュは \\ でエスケープ):

{
  "mcpServers": {
    "kaken": {
      "command": "node",
      "args": ["C:\\Users\\<name>\\kaken-mcp-server\\dist\\index.js"],
      "env": {
        "KAKEN_APPID": "YOUR_APPID_HERE"
      }
    }
  }
}

設定後、Claude Desktop を再起動するとツールが利用可能になる。

2. 動作確認

Claude に以下のように依頼すれば、自動的にツールが呼ばれる:

  • 「KAKEN で AI 内視鏡の先行研究を調べて」

  • 「研究者番号 80802743 の科研費業績を取得して」

  • 「19K20626 の研究課題の詳細を見せて」

  • 「昭和大学の消化器内科学分野の課題を年度別に集計して」

3. ツール仕様

kaken_search_projects

引数

型

説明

kw

string

フリーワード検索(全フィールド対象)

qa

string

研究課題名で検索

qb

string

研究課題番号(例: 19K20626)

qg

string

研究者の姓名

qh

string

研究者の所属機関

qm

string

研究者番号(8桁)

qc

string

研究種目(例: 若手研究)

qd

string

審査区分/研究分野

qe

string

研究機関

qf

string

キーワード

s1

string

助成開始年度 From

s2

string

助成終了年度 To

o1

1-4

助成期間の検索条件(1=開始年度〈既定〉, 2=終了年度, 3=期間の一部, 4=全部)

od

1-5

ソート(1=適合度, 2=開始年新しい順〈既定〉, 3=古い順, 4=配分額多い順, 5=少ない順)

rw

integer

1ページの件数(20/50/100/200/500、既定100。中間値は近い許容値に切り上げ)

start

integer

開始位置(既定1)

lang

ja / en

言語(既定 ja)

format

ai / table / json

出力形式(既定 ai)

kaken_search_researchers

kw, qg, qm, qh(現在の所属機関), qq(部局), qs(職名), qe, qd, rw, start, lang, format を受け取る。

研究者検索API(nrid.nii.ac.jp)は XML 非対応のため、内部では format=json で取得して パースしている(研究課題検索は従来どおり XML)。取得可能な検索結果は最大1000件。

kaken_get_project

  • awardNumber (必須): KAKEN研究課題番号

  • format: ai / json

kaken_get_researcher_grants

  • researcherNumber (必須): 研究者番号

  • rw: 件数(既定200。一人の研究者の全課題を取得するため大きめ)

  • format: ai / table / json

4. 出力形式

ai(既定)は AI に読ませやすい圧縮 Markdown:

## 1. [19K20626] IIIFとTEIを用いたオンライン翻刻支援システムの開発
- 研究代表者: 中村 覚(80802743)/ 東京大学 史料編纂所 / 助教
- 研究種目: 若手研究
- 研究期間: 2019-04-01 〜 2023-03-31
- 状態: 完了
- 配分額: 直接 ¥3,500,000 / 間接 ¥1,050,000 / 合計 ¥4,550,000
- キーワード: IIIF, TEI, 人文情報学
- URL: https://kaken.nii.ac.jp/grant/KAKENHI-PROJECT-19K20626/

table は Markdown のテーブル、json は構造化データ。

5. 開発

npm run dev      # tsx で直接実行(ホットリロード相当)
npm run build    # tsc でビルド
npm start        # node でビルド済みを実行

6. 利用上の注意

  1. 短時間の大量アクセスを避けること(KAKEN 利用規約)

  2. APIで返る所属情報は採択時点のものであり、現在の所属とは異なる場合がある

  3. 検索結果の二次利用には KAKEN の利用規約を確認すること

参考

Available Tools

4 tools
kaken_get_projectA

研究課題番号(例: 19K20626)を指定して1件の研究課題詳細を取得する。課題番号がすでにわかっているときの専用ツール。kaken_search_projects に qb を渡すのと同等だが、用途が明確なのでこちらを優先する。

Inputs: awardNumber (required), format.

kaken_get_researcher_grantsA

研究者番号(8桁)を指定して、その研究者が代表者・分担者として関与した全課題を取得する。特定研究者の科研費業績把握、時系列分析、累計配分額の集計に使う。氏名検索だと同姓同名で混じる可能性があるため、番号がわかる場合はこちらを使う。

Inputs: researcherNumber (required), rw, format.

kaken_search_projectsA

KAKEN(科学研究費助成事業データベース)から研究課題を検索する。競合・先行研究調査、特定分野の採択動向把握、申請書作成時の参考データ収集に使う。フリーワード(kw)・課題名(qa)・分野(qd)・機関(qe)・年度(s1/s2)などを組み合わせて検索でき、結果はAI向けに圧縮されたMarkdown(課題番号/代表者/所属/種目/期間/配分額/キーワード/概要)で返る。

Inputs: kw, o1, od, qa, +14 more.

kaken_search_researchersA

KAKEN研究者データベース(NRID)から研究者を検索する。氏名・研究者番号・所属機関・研究分野から研究者の所属・職位・URLを取得する。特定の研究者を特定したい場合や、機関・分野の研究者一覧を取得したい場合に使う。

Inputs: kw, qd, qe, qg, +8 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: kaken_get_project retrieves a single project by ID, kaken_get_researcher_grants retrieves all grants for a researcher, kaken_search_projects queries projects by criteria, and kaken_search_researchers queries researchers. No overlaps.

    Naming Consistency5/5

    All tools follow a consistent 'kaken_<verb>_<noun>' pattern using snake_case. Verbs 'get' and 'search' are used appropriately for direct retrieval vs. querying.

    Tool Count5/5

    4 tools well-scoped for a read-only database access server covering search and specific retrieval for both projects and researchers.

    Completeness5/5

    The tool set covers all essential operations: searching for projects and researchers, retrieving a specific project, and listing all grants for a researcher. No obvious gaps given the read-only nature.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for academic paper search that integrates with AI assistants (e.g., Claude Code, Cursor), enabling them to search and retrieve academic paper metadata.
      42 PyPI
      246
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Japan's Jグランツ grant application system, enabling LLMs to search and retrieve subsidy information via natural language.
      51
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server for searching Japanese government procurement notices via the Kanpou API. Enables LLMs to search by date, keyword, or detailed criteria.
      3
      1
      MIT