本文へスキップ
公式

UniProt MCP によるタンパク質研究

Claude Desktop から reviewed UniProtKB 記録を取得し、種と accession を明確にして機能の根拠と出典識別子を保持します。

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

できるようになること

  • 遺伝子、種、reviewed 状態でタンパク質を検索。
  • 根拠と相互参照を含む注釈記録を取得。

構築するもの

範囲

Claude Desktop に Node.js >=24 と @cyanheads/uniprot-mcp-server 0.2.4 を使用します。公開 UniProt 検索は API キー不要です。ローカル MCP は外部 UniProt API を使用し、取得注釈は Claude に渡ります。既存記録の取得であり、新しい構造や臨床予測ではありません。

識別子と根拠

ヒトは taxon 9606 に限定し reviewed 状態を記録します。遺伝子名だけでは曖昧になり得ます。詳細は標準 accession を使い、アイソフォーム接尾辞と予測配列は別途扱います。注釈や相互参照はデータベース版に依存するため出典、取得日、根拠ラベルを保持します。

UniProt 記録取得

UniProt MCP (cyanheads)

構成リソース

UniProt MCP (cyanheads)

UniProt 記録取得 · 0.2.4

固定 npm パッケージ。オンライン注釈は変化し得ます。

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

リソースを見る

互換性

クライアント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": {
    "uniprot-mcp-server": {
      "command": "/ABSOLUTE/PATH/TO/node",
      "args": [
        "/ABSOLUTE/PATH/.mcp-packages/node_modules/@cyanheads/uniprot-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": {
    "uniprot-mcp-server": {
      "command": "C:\\ABSOLUTE\\PATH\\TO\\node.exe",
      "args": [
        "C:\\ABSOLUTE\\PATH\\.mcp-packages\\node_modules\\@cyanheads\\uniprot-mcp-server\\dist\\index.js"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}
公式出典

期待される結果

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

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

全プラットフォーム

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

公式出典

期待される結果

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

6. ヒト TP53 記録を取得

全プラットフォーム

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

uniprot_search_proteins を query gene:TP53 AND organism_id:9606、reviewed=true で呼び出し、得られたヒト TP53 の標準エントリーを uniprot_get_entry で取得してください。accession、reviewed、遺伝子、種、配列長、機能、根拠の引用、UniProt リンク、取得日を示し、P04637 か確認してください。不明な注釈を保持し、臨床推奨に置き換えないでください。
公式出典

期待される結果

参照基準:reviewed のヒト TP53、P04637、標準配列長 393。取得記録と https://www.uniprot.org/uniprotkb/P04637/entry を照合し、変異体やアイソフォームは別に表示します。今回の実行結果ではありません。

7. 競合する検索条件を確認

全プラットフォーム

上流ツールは text_search または query の一方だけを許可します。

uniprot_search_proteins に text_search="TP53" と query="gene:TP53" の両方を渡し、検証エラーを報告し、エントリーを作らないでください。
公式出典

期待される結果

競合する要求が拒否される。

トラブルシューティング

  • 起動失敗:Node 24 以降、node/モジュールの絶対パス、JSON 構文、lockfile を確認。
  • ツール不足:完全再起動し Developer ログを確認。
  • HTTP 429/タイムアウト:要求数を減らし、ページングと待機を挟む再試行を使用、成功済みの部分結果を保持。
  • 欠落フィールド:推測で補わず取得不能と表示。
  • 種違い:organism_id:9606 に限定し取得 taxon を確認。
  • 複数候補:accession と reviewed を比較。
  • 大きな記録:必要な section に絞り、accession と出典を保持。
  • アイソフォーム失敗:詳細に標準 accession を使い、アイソフォーム配列は別取得。
  • ID 変換処理中:再送せず返された ticket を確認。
まだ動作しません

代替案

UniProt サイトや REST API を直接利用できます。構造記録は別の RCSB ワークフローで扱い、UniProt 注釈だけで構造品質を判断しません。