プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Uniprot MCP Server

作者:cyanheadsバージョン 0.4.1i★ 2iパソコンでもクラウドでも公式サイト ↗
レジストリ名io.github.cyanheads/uniprot-mcp-server

インストール方法

What it does

Protein research over UniProtKB: search by function, fetch curated records, map IDs, proteomes.

  • Connects パソコンでもクラウドでも
  • Account or key No key needed
  • Category 検索・AIの記憶

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

作者:google-research★ 35,6291 個の skill

Skill · 手順書

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

作者:BigBodyCobain★ 11,6021 個の skill

Skill · 手順書

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

作者:gosom★ 8,2091 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気15/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア35/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: 12 (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Uniprot MCP Server をインストールして。https://mcp.popnx.com/i/cyanheads-uniprot-mcp-server.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(uniprot.caseyjhand.com)を通ります · ✓ コマンド確認済み 2026年11月18日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Uniprot MCP Server
    Remote MCP server URL · アドレスhttps://uniprot.caseyjhand.com/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsUniprot MCP Server

  4. 試してみる

    Uniprot MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Uniprot MCP Server を使っていると言うか、回答に Uniprot MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前Uniprot MCP Server
    Connection · アドレスhttps://uniprot.caseyjhand.com/mcp
  3. チャットで Uniprot MCP Server を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から Uniprot MCP Server を選びます

  4. 試してみる

    Uniprot MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が Uniprot MCP Server を使っていると言うか、回答に Uniprot MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user uniprot https://uniprot.caseyjhand.com/mcp
  3. Claude Code で /mcp と入力

    Uniprot MCP Server が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    Uniprot MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Uniprot MCP Server を使っていると言うか、回答に Uniprot MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    Uniprot MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Uniprot MCP Server を使っていると言うか、回答に Uniprot MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    Uniprot MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Uniprot MCP Server を使っていると言うか、回答に Uniprot MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://uniprot.caseyjhand.com/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Uniprot MCP Server を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user uniprot https://uniprot.caseyjhand.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "uniprot": {
      "url": "https://uniprot.caseyjhand.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "uniprot": {
      "type": "http",
      "url": "https://uniprot.caseyjhand.com/mcp"
    }
  }
}

パソコンにインストール

Claude Code

claude mcp add --scope user uniprot -- npx -y @cyanheads/uniprot-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "uniprot": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/uniprot-mcp-server"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "uniprot": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/uniprot-mcp-server"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "uniprot": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/uniprot-mcp-server"
      ]
    }
  }
}

自分で入力する値

  • MCP_LOG_LEVEL env
    出力する最小のログレベルを設定します(例: 'debug'、'info'、'warn')
    英語の原文を見るSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • UNIPROT_BASE_URL env
    UniProt REST のベース URL。プライベートミラーやテスト用に上書きします。
    英語の原文を見るUniProt REST base URL. Override for a private mirror or testing.
  • UNIPROT_TIMEOUT_MS env
    HTTP リクエストごとのタイムアウト(ミリ秒)
    英語の原文を見るPer-request HTTP timeout in milliseconds.
  • UNIPROT_ID_MAPPING_BUDGET_MS env
    uniprot_map_ids が再開可能なチケットを返す前にマッピングジョブをインラインでポーリングするミリ秒数。UNIPROT_TIMEOUT_MS より小さく保ってください。
    英語の原文を見るMilliseconds uniprot_map_ids polls a mapping job inline before returning a resumable ticket. Keep it below UNIPROT_TIMEOUT_MS.
  • UNIPROT_DEFAULT_PAGE_SIZE env
    呼び出し側が size を指定しない場合の、検索およびプロテオーム蛋白質一覧のページサイズ(1〜500)。
    英語の原文を見るPage size (1–500) for search and proteome protein listing when the caller leaves size unset.
  • UNIPROT_CLAMP_LIMITS env
    上限を超えるサイズは通知付きで 500 を返し、任意の section_limit を受け付け、uniprot_get_entry で最大 500 件のアクセッション番号を受け付けます(最初の 20 件の重複なしを取得し、残りは保留)。false にすると拒否…
    英語の原文を見るServe an over-the-cap size at 500 with a notice, accept any section_limit, and accept up to 500 accessions on uniprot_get_entry (the first 20 distinct fetched, the rest deferred). Set false to reject…

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
417/週
接続方法
パソコンでもクラウドでも
最新バージョンi
0.4.1
レジストリ公開日i
2026年11月18日
コードの最終更新i
2026年11月18日
最終確認
2026年11月18日
作者
cyanheads
パッケージ
npm: @cyanheads/uniprot-mcp-server
npm: @cyanheads/uniprot-mcp-server
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月18日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • uniprot_search_proteins

    Search UniProtKB and return curated protein records. Pass text_search for a plain-language query (the 80% case) or query for the full Lucene field syntax (gene:TP53 AND organism_id:9606 AND reviewed:true) — exactly one is required. Reviewed (Swiss-Prot) entries are manually curat

  • uniprot_get_entry

    Fetch full curated UniProtKB entries by accession in one batch of up to 20 distinct accessions; repeats collapse, and any further accessions return in deferredAccessions to pass as accessions on the next call. Each entry carries alternative names, function, EC numbers and catalyt

  • uniprot_map_ids

    Translate identifiers across databases via UniProt's ID-mapping service — gene names to accessions, accession to PDB / Ensembl / RefSeq / ChEMBL / GeneID, and back. The job runs asynchronously; this tool submits it and polls within a budget. A running job returns status "running"

  • uniprot_get_proteome

    Fetch the reference proteome for an organism by UPID (e.g. "UP000005640") or NCBI taxon ID (e.g. 9606) — provide exactly one. Returns metadata inline: proteome type, total protein count, BUSCO completeness (score, complete/fragmented/missing counts, lineage dataset), and the geno

  • uniprot_get_taxonomy

    Resolve a taxonomy record by NCBI taxon ID (e.g. 9606) or organism name (e.g. "Homo sapiens" or "human") — provide exactly one. Exact case-insensitive scientific names take priority, then common names, mnemonic and aliases; stray double quotes and backslashes are tolerated after

  • uniprot_get_sequence

    Fetch the canonical amino-acid sequence (FASTA) for a UniProtKB accession, with length and the parsed header. Set include_isoforms to also return the alternatively-spliced isoform sequences. This is the cheap sequence-only path — for the full functional record use uniprot_get_ent

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月18日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント cyanheads で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:今日

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • ✓ 合格

    エンドポイントが応答する

    548ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    6件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

クラウドのアドレスは直近 4 回中 4 回応答 · 最新 548 ms · 確認日 2026年11月18日

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cyanheads-uniprot-mcp-server.svg)](https://mcp.popnx.com/en/servers/cyanheads-uniprot-mcp-server)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

検索・AIの記憶のほかのサーバーとの比較i

  • このカテゴリのほかの6384件のうち82%よりスターが多い
  • このカテゴリのほかの6384件のうち98%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの6384件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Uniprot MCP Serverは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は今日、最新バージョン(0.4.1)がレジストリに届いたのは今日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

作者:every-app広く使われている★ 2.8万4 日前更新

クラウドで動く✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

作者:exa-labs広く使われている★ 52422 か月前更新

クラウドで動く✓ 提供元 · exa.aiPopNx チームが実際に試用

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

作者:MicrosoftDocs広く使われている★ 199612 か月前更新

クラウドで動く✓ 提供元 · microsoft.comPopNx チームが実際に試用

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

作者:proxysoul成長中★ 16242 か月前更新

クラウドで動く✓ empryo.com
似たものと比べる
これ
Uniprot MCP Server
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいはいはいいいえいいえ
基本チェック5/55/52/44/44/44/4
ライセンスApache-2.0MITMITCC-BY-4.0NOASSERTIONApache-2.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

@cyanheads/uniprot-mcp-server Search UniProtKB by protein function, fetch curated records, map IDs across databases, and pull reference proteomes, taxonomy, and sequences via MCP. STDIO or Streamable HTTP. 6 Tools • 2 Data Resources • 1 Prompt • 1 Skill

Public Hosted Server: https://uniprot.caseyjhand.com/mcp


Overview

Protein research over UniProtKB. Search by function or gene, fetch curated records, map identifiers from Ensembl, ChEMBL, RefSeq, PDB, and more, and pull reference proteomes, taxonomy, and sequences.

Tools
ToolDescription
uniprot_search_proteinsSearch UniProtKB by plain text or a Lucene field query, with the reviewed (Swiss-Prot) filter foregrounded and optional server-side facet counts. Cursor-paginated. The discovery entry point.
uniprot_get_entryFetch full curated entries by accession in one batch (up to 20) — function, catalytic activity, disease, variants, isoforms, GO terms, cross-references. Partial-success output; an oversized record returns a section outline.
uniprot_map_idsTranslate identifiers across databases via UniProt's async ID-mapping service — gene names, Ensembl, RefSeq, ChEMBL, PDB, GeneID ↔ UniProtKB accessions. Polls within a budget; running jobs return a ticket and completed pages return a continuation.
uniprot_get_proteomeFetch a reference proteome by UPID or NCBI taxon ID — protein count, BUSCO completeness, genome assembly inline, plus an opt-in capped page of the proteins.
uniprot_get_taxonomyResolve a taxonomy record by NCBI taxon ID or organism name — exact name matching, rank, parent, full lineage, and optionally the immediate children, cursor-paginated.
uniprot_get_sequenceFetch the canonical amino-acid sequence (FASTA) for an accession, with length and parsed header — and optionally the isoform sequences. The cheap sequence-only path.
Resources
ResourceDescription
uniprot://entry/{accession}A curated UniProtKB entry by accession — the resource mirror of uniprot_get_entry for a single accession.
uniprot://taxonomy/{taxonId}A taxonomy record by NCBI taxon ID — name, rank, parent, full lineage. The mirror of uniprot_get_taxonomy by ID.

All resource data is also reachable via tools — tool-only clients lose nothing. UniProtKB is far too large to enumerate, so there is no resource list(); discovery is uniprot_search_proteins's job.

Prompts
PromptDescription
uniprot_protein_dossierGuided protein-research workflow — resolve an identifier, fetch the curated entry, pull disease and variants, and surface cross-references for structure, citations, and bioactivity.
Agent skill

The UniProt guide covers protein identity, species versus strain scope, mapping completeness, and evidence-backed interpretation. It ships with plugin, npm, MCPB, and Docker installations and is available over MCP at skill://uniprot-guide/SKILL.md.

Capability reference

uniprot_search_proteins tool
  • text_search for plain language or query for Lucene field syntax (gene, organism_id, taxonomy_id, keyword, go, reviewed, protein_name, family, length, existence, accession) — exactly one. Plain-text punctuation and uppercase Boolean words are escaped. Structured queries reject unbalanced parentheses. Optional facets return count breakdowns (e.g. reviewed, model_organism)
  • The organism_id input restricts the whole query to that taxon and its descendants. For exact-node scope, use organism_id: inside query instead
  • reviewed defaults to true (Swiss-Prot only); false searches both tiers (put reviewed:false in query for TrEMBL only). Every hit carries reviewed, annotationScore, and proteinExistence
  • Forward-only cursor pagination; returns totalResults and the effective query. Cursors bind to this tool and the exact assembled query, including organism/reviewed filters. Changing size, fields, or facets keeps continuation valid; a changed query, malformed token, or legacy raw cursor fails invalid_cursor: restart without it
  • Inactive accessions (merged, demerged, or deleted) go in inactive[] with the reason and replacements, not in results[]

uniprot_get_entry tool
  • Up to 20 accessions per call, from uniprot_search_proteins or uniprot_map_ids (strip any -N isoform suffix). Sectioned record: function, catalytic activity, cofactors, subcellular location, disease, PTMs, natural variants, isoforms, domains, GO terms, keywords, cross-references. fields trims the output; identity and provenance fields are always kept
  • Resolved entries come back in succeeded[], unknown or inactive ones in failed[], so one bad accession doesn't abort the batch. An inactive accession's error names the merge target, the demerge products, or the UniParc ID
  • Initial responses exceeding 24,000 UTF-8 bytes across content[] and structuredContent return kind: "outline". A single resolved accession returns a section listing; an oversized batch returns outlinedEntries in request order, preserving every failed[] entry. Re-call each outlined accession individually, then use sections: [...] for the parts you need. Explicit sections render every returned item, including all cross-reference IDs; a very large list section pages with section_limit (1–500) and section_offset, reporting totalCount and nextOffset

uniprot_map_ids tool
  • from_db / to_db are validated enums (e.g. Gene_Name, Ensembl, RefSeq_Protein, ChEMBL, PDB, GeneID, and UniProtKB_AC-ID as a source); an unknown database fails before any request. Target UniProtKB-Swiss-Prot for reviewed accessions only, or UniProtKB to include TrEMBL. Mapping tax_id restricts submission to an exact node, excluding descendants; use the intended strain's taxon ID when needed
  • Submits the job and polls within a time budget. A job still running returns status: "running" with a ticket; pass that ticket alone to poll it. A finished call returns status: "finished" with one page, and continuation (pass it alone) fetches the next; no continuation means the last page
  • mappedCount counts the current page; totalMappings is UniProt's job-wide total when available. unmappedIds is UniProt's job-wide failed-ID metadata, repeated on completed pages rather than inferred from the displayed rows
  • UniProtKB targets include available entry name, reviewed status, organism, and primary gene. Inactive targets carry their reason and replacements. Metadata or enrichment outages fall back to generic identifier rows with a notice; jobs above UniProt's 100,000-mapping enrichment limit remain pageable
  • Terminal job failures use mapping_failed with UniProt's safe error message and recovery guidance. Only an explicitly unsupported database combination at submission uses unsupported_db_pair
  • A rejected completed-page continuation (HTTP 400), unknown page, or expired job fails invalid_continuation with restart guidance. Upstream outages retain their upstream error classification

uniprot_get_proteome tool
  • Provide exactly one of upid (e.g. UP000005640) or taxon_id; both or neither fails validation. Resolve an organism name to a taxon ID first with uniprot_get_taxonomy. Taxon lookup prefers an exact reference proteome, then a unique descendant reference. Multiple descendants return candidate UPIDs and organism identities for explicit selection, with a next-page link when suggestions are incomplete
  • Returns proteome type, total protein count, BUSCO completeness (score, complete/fragmented/missing counts, lineage dataset), and genome assembly accession
  • Proteins are opt-in via include_proteins (human has ~147,506) and come back as a capped page with a forward cursor; narrow with query (UniProtKB Lucene syntax). Cursors bind to the resolved UPID, exact query, and tool; a taxon ID and UPID resolving to the same proteome may share a cursor, and size may change. Changed membership or a legacy raw cursor fails invalid_cursor: restart without it

uniprot_get_taxonomy tool
  • Provide exactly one of taxon_id (NCBI numeric ID) or name (organism name); both or neither fails validation. Gives the taxon ID that uniprot_search_proteins (organism_id) and uniprot_get_proteome (taxon_id) expect
  • Name matching prefers exact case-insensitive scientific names, then common names, mnemonics, and aliases. Quote/backslash-tolerant matching follows exact matching. Ties or partial matches return candidate taxon IDs instead of selecting the first hit
  • Name resolution shares a 45-second budget across candidate pages and the selected record lookup. If candidate scanning cannot finish, incomplete_candidates supplies partial suggestions and a candidate-search URL; use an explicit taxon ID or narrow the name
  • Returns scientific and common name, mnemonic, rank, parent, and the full lineage (root → near ancestor)
  • include_children adds the immediate child taxa, 100 per page with the total count and a cursor for the next page. A cursor sent with a different taxon fails invalid_cursor

uniprot_get_sequence tool
  • Returns the canonical sequence with its length and parsed FASTA header; include_isoforms adds the isoform sequences. Accessions come from uniprot_search_proteins or uniprot_map_ids (strip any -N isoform suffix)
  • A merged accession returns its merge target's sequences, with the requested accession in mergedFrom; a demerged or deleted one fails not_found naming its replacements or UniParc ID

uniprot://entry/{accession} resource
  • Same record as uniprot_get_entry for a single accession, addressed by URI.

冒頭だけを表示しています。続きはリポジトリで読めます