本文へスキップ
公式

Claude + PubChem による化学研究

ローカル PubChem MCP を介し Claude Desktop で化合物名を CID に解決し、出典を確認できる物性を取得します。

難易度: 中級 費用: 無料・有料混在 プライバシー: クラウド ~30 分
セットアップ開始

できるようになること

  • 名称と識別子を PubChem CID に解決。
  • 出典と欠落値を保持して化合物情報を取得。

構築するもの

対象範囲

@cyanheads/pubchem-mcp-server 0.6.5 と Node.js >=24 を使用します。MCP はローカルで実行し、公開 PubChem PUG REST/PUG View を検索し、対話は Claude のクラウドで処理します。基本検索に PubChem API キーは不要です。化合物情報の取得であり、実験検証済みの物性予測ではありません。サーバー版と取得日を記録し、PubChem XLogP を RDKit Crippen logP と呼び替えないでください。

PubChem MCP ツール

PubChem MCP (cyanheads)

化合物データの出典

PubChem PUG REST

構成リソース

PubChem MCP (cyanheads)

PubChem MCP ツール · 0.6.5

固定 npm パッケージ、ソースコミット 1b179c5043345b9029b269980ac4ad5c0dbad15b

上流のライセンスとクライアント・サービスの利用条件を確認してください。

リソースを見る

PubChem PUG REST

化合物データの出典 · PUG REST / live API

オンラインデータは変わり得るため CID と取得日を記録。

上流のライセンスとクライアント・サービスの利用条件を確認してください。

リソースを見る

互換性

クライアントOSアーキテクチャバージョン要件
Claude Desktop macOS指定なし構成リソースの要件を参照
Claude Desktop Windows指定なし構成リソースの要件を参照

セットアップとテスト

1. Node.js と Claude Desktop を準備

全プラットフォーム

npm を含む Node.js 24 以降と Claude Desktop を導入します。ローカル MCP が許可され、対象データベースへ HTTPS 接続できることを確認します。この Node 構成では Bun は不要です。

node --version
npm --version
公式出典

期待される結果

Node は v24 以降、npm が利用できる。

2. 固定 MCP パッケージを専用ディレクトリに導入

全プラットフォーム

新しい書き込み可能な作業ディレクトリで実行します。.mcp-packages に導入し、検証用に lockfile を保持します。上流の npx とローカル dist/index.js は同じ公開パッケージを使用します。

npm install --prefix .mcp-packages @cyanheads/[email protected]
npm ls --prefix .mcp-packages --depth=0
公式出典

期待される結果

指定した正確なパッケージ版が導入される。

3. macOS の Claude Desktop を設定

macOS

Settings > Developer > Edit Config で mcpServers に追加します。node 実行ファイルも含め、すべてを実際の絶対パスに置き換え、既存項目を保持します。基本検索は API キー不要です。任意のキーやメールアドレスは私有設定に保存します。

{
  "mcpServers": {
    "pubchem-mcp-server": {
      "command": "/ABSOLUTE/PATH/TO/node",
      "args": [
        "/ABSOLUTE/PATH/.mcp-packages/node_modules/@cyanheads/pubchem-mcp-server/dist/index.js"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}
公式出典

期待される結果

有効な JSON が Node 24 以降で導入済みパッケージを stdio 起動する。

4. Windows の Claude Desktop を設定

Windows

Settings > Developer > Edit Config で mcpServers に追加します。node 実行ファイルも含め、すべてを実際の絶対パスに置き換え、既存項目を保持します。基本検索は API キー不要です。任意のキーやメールアドレスは私有設定に保存します。

{
  "mcpServers": {
    "pubchem-mcp-server": {
      "command": "C:\\ABSOLUTE\\PATH\\TO\\node.exe",
      "args": [
        "C:\\ABSOLUTE\\PATH\\.mcp-packages\\node_modules\\@cyanheads\\pubchem-mcp-server\\dist\\index.js"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}
公式出典

期待される結果

有効な JSON が Node 24 以降で導入済みパッケージを stdio 起動する。

5. 再起動してツールを確認

全プラットフォーム

Claude Desktop を完全に終了して再起動し、Developer 状態とコネクター一覧を調べます。必要なツール:pubchem_search_compounds, pubchem_get_compound_details。

公式出典

期待される結果

接続が成功し、指定したツールが利用できる。

6. アスピリンを検索して確認

全プラットフォーム

新規チャットに入力し、二つの実際の呼び出しを確認。

pubchem_search_compounds で aspirin を名前検索し、得られた CID に pubchem_get_compound_details を呼び出してください。CID、分子式、分子質量、TPSA、取得できた XLogP、PubChem リンクと取得日を示し、CID 2244 に解決されるか確認してください。計算物性と実験根拠を区別し、欠落値を保持し、毒性や治療推奨を推測しないでください。
公式出典

期待される結果

期待する基準:アスピリン CID 2244、C9H8O4、約 180.16 g/mol。他の項目は実際の取得値と単位を示し、https://pubchem.ncbi.nlm.nih.gov/compound/2244 を添える。今回の実測結果ではない。

7. 見つからない識別子を確認

全プラットフォーム

意図的に存在しない名称で検索を繰り返す。

ChemAIAtlas-no-such-compound-20261007 を検索し、該当なしまたは実際の API エラーを報告してください。CID を作らないでください。
公式出典

期待される結果

識別子や物性が作り出されない。

トラブルシューティング

  • 起動失敗:Node 24 以降、node/モジュールの絶対パス、JSON 構文、lockfile を確認。
  • ツール不足:完全再起動し Developer ログを確認。
  • HTTP 429/タイムアウト:要求数を減らし、ページングと待機を挟む再試行を使用、成功済みの部分結果を保持。
  • 欠落フィールド:推測で補わず取得不能と表示。
  • 名称が曖昧:構造と CID を比較して選ぶ。
  • 不正 SMILES:繰り返し要求せず入力を修正。
  • 安全性や活性の項目なし:原記録を確認。欠落は安全性の根拠ではない。
まだ動作しません

代替案

同じ CID を PubChem サイトまたは PUG REST で直接取得できます。ローカル RDKit 計算は別の代替手段で、記述子の定義が異なります。