PubMed MCP Server
by masa-med-ai
README.md
# 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 の一括処理 |
---
## セットアップ
### 1. 準備するもの
- **Node.js 18 以上**(https://nodejs.org/ )
- **Cloudflare アカウント**(無料。https://dash.cloudflare.com/sign-up )
- (任意)**NCBI API キー**:NCBI の利用上限が 3回/秒 → 10回/秒 に上がります。
[NCBI アカウント設定](https://account.ncbi.nlm.nih.gov/settings/) の「API Key Management」から無料で発行できます。
### 2. ダウンロードとインストール
```bash
git clone https://github.com/masa-med-ai/pubmed-mcp-selfhost.git
cd pubmed-mcp-selfhost
npm ci
```
### 3. Cloudflare にログイン
```bash
npx wrangler login
```
ブラウザが開いたら **Allow** を押します。
### 4. デプロイ
```bash
npx wrangler deploy
```
最後に表示される `https://pubmed-mcp.<あなたのサブドメイン>.workers.dev` を控えておきます。
初めてのときは、workers.dev のサブドメイン名を決めるよう聞かれることがあります。
### 5. 秘密の文字列(MCP_SECRET)を設定
推測されないランダムな文字列を作って登録します。
```bash
openssl rand -hex 32
```
表示された64文字をコピーし、次のコマンドを実行して貼り付けます。
```bash
npx wrangler secret put MCP_SECRET
```
> Windows で `openssl` がない場合は、PowerShell で次を実行して作れます。
> `-join ((1..64) | % { '{0:x}' -f (Get-Random -Max 16) })`
### 6. (任意)NCBI API キーを設定
```bash
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
```bash
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 も新しいものに更新してください。
### アップデート
```bash
git pull
npm ci
npx wrangler deploy
```
設定した MCP_SECRET と NCBI_API_KEY はそのまま引き継がれます。
---
## 開発者向け
```bash
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](LICENSE)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessOutdated data