Skip to main content
Glama

PubMed MCP Server(セルフホスト版)

PubMed/PMC の論文データを Claude などの AI から使えるようにするリモート MCP サーバーです。 自分の Cloudflare アカウントにデプロイして、自分ひとりで使うことを前提にしています。

  • Google ログイン(OAuth)なし。Google Cloud の設定も不要です

  • 秘密の URL を知っている人だけが使えます

  • Cloudflare Workers の無料プランで動きます

ツール一覧

ツール

内容

search

PubMed 検索(MeSH、絞り込み、並べ替え、ページ送り)

fetch / fetch_batch

PMID から抄録を取得

get_full_text

PMC の全文を取得(セクション指定可)

count

ヒット件数だけを取得

find_similar_articles

類似論文を検索

export_to_ris

EndNote / Zotero / Mendeley 用の RIS 形式で出力

get_citation_counts

NIH iCite による被引用数

convert_ids

PMID / PMCID / DOI の相互変換

batch_process

複数 PMID の一括処理


Related MCP server: pubmed-mcp-server

セットアップ

1. 準備するもの

2. ダウンロードとインストール

git clone https://github.com/masa-med-ai/pubmed-mcp-selfhost.git
cd pubmed-mcp-selfhost
npm ci

3. Cloudflare にログイン

npx wrangler login

ブラウザが開いたら Allow を押します。

4. デプロイ

npx wrangler deploy

最後に表示される https://pubmed-mcp.<あなたのサブドメイン>.workers.dev を控えておきます。 初めてのときは、workers.dev のサブドメイン名を決めるよう聞かれることがあります。

5. 秘密の文字列(MCP_SECRET)を設定

推測されないランダムな文字列を作って登録します。

openssl rand -hex 32

表示された64文字をコピーし、次のコマンドを実行して貼り付けます。

npx wrangler secret put MCP_SECRET

Windows で openssl がない場合は、PowerShell で次を実行して作れます。 -join ((1..64) | % { '{0:x}' -f (Get-Random -Max 16) })

6. (任意)NCBI API キーを設定

npx wrangler secret put NCBI_API_KEY

7. 接続用 URL

あなた専用の接続 URL は次のとおりです。

https://pubmed-mcp.<あなたのサブドメイン>.workers.dev/mcp/<MCP_SECRET>

この URL はパスワードと同じです。 他人に見せたり、SNS や公開リポジトリに貼ったりしないでください。


AI への接続

Claude(claude.ai / Claude デスクトップ / スマホアプリ)

  1. 設定 → コネクタ → カスタムコネクタを追加

  2. 名前に PubMed、URL に上の接続 URL を入れて追加

  3. 認証の設定は空欄のままで構いません

Claude Code

claude mcp add --transport http pubmed "https://pubmed-mcp.<あなたのサブドメイン>.workers.dev/mcp/<MCP_SECRET>"

その他の MCP クライアント

Streamable HTTP に対応したクライアントなら、接続 URL を登録するだけで使えます。


よくあるトラブル

症状

原因と対処

MCP_SECRET is not set...(503)と表示される

手順5が終わっていないか、文字列が32文字未満です。設定し直してください

Not Found(404)になる

URL の /mcp/ 以降が MCP_SECRET と一致していません

検索が遅い・エラーになる

NCBI の利用上限に当たっている可能性があります。手順6で API キーを設定してください

URL が漏れたかもしれないとき

新しい文字列を作って手順5をやり直します。古い URL はすぐ使えなくなるので、AI 側の接続 URL も新しいものに更新してください。

アップデート

git pull
npm ci
npx wrangler deploy

設定した MCP_SECRET と NCBI_API_KEY はそのまま引き継がれます。


開発者向け

npm run dev          # ローカル起動(http://localhost:8787)
npm run type-check   # 型チェック
npm test             # テスト(NCBI に実際にアクセスします)

ローカルで動かすときは、プロジェクト直下に .dev.vars を作って秘密の値を書きます(Git には含まれません)。

MCP_SECRET=<32文字以上のランダム文字列>
NCBI_API_KEY=<任意>

構成

  • src/index.ts:入口。/mcp/<MCP_SECRET> だけを MCP として処理し、それ以外は 404 を返します

  • src/secret.ts:秘密文字列の比較(タイミング攻撃対策の定数時間比較)

  • src/tools.ts:MCP ツールの定義

  • src/pubmed-client.ts:NCBI E-utilities / PMC / iCite のクライアント

  • src/ris-exporter.ts:RIS 出力

MCP はステートレスな Streamable HTTP で動かしています。

ライセンス

MIT License

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables searching for academic papers and preprints across multiple platforms including Semantic Scholar, arXiv, PubMed, and CrossRef. It provides access to research records, DOI lookups, and journal metadata through a unified interface deployed on Cloudflare Workers.
      2
      -
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables searching PubMed and Europe PMC and retrieving biomedical literature metadata, abstracts, and full text via PMC, Europe PMC, or Unpaywall fallbacks. Also supports citation formatting in APA/MLA/BibTeX/RIS/Vancouver, MeSH term lookup, identifier conversion, related-article discovery, and citation resolution over stdio or Streamable HTTP.
      9 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables searching PubMed and Europe PMC, fetching article metadata and full text through PMC, Europe PMC, or Unpaywall, and working with citations, related articles, MeSH terms, spelling corrections, and DOI/PMID/PMCID conversion. It runs over STDIO or Streamable HTTP as a local process or hosted endpoint.
      9 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables users to search PubMed and Europe PMC and retrieve article metadata, full text from PMC/Europe PMC/Unpaywall, citations in multiple formats, related and citing works, MeSH terms, and resolved DOI/PMID/PMCID or partial-citation references. Runs over STDIO or Streamable HTTP, locally or via a public hosted endpoint.
      9 npm
      MIT