Skip to main content
Glama

amr-mcp

CI PyPI

An MCP server that lets AI assistants (Claude, Codex, Cursor…) query antimicrobial resistance (AMR) data from public, free sources:

  • NCBI Reference Gene Catalog, the curated database behind AMRFinderPlus: ~11,500 AMR genes, point mutations, stress and virulence genes

  • NCBI E-utilities: protein and nucleotide sequences, PubMed references

  • UniProtKB: protein function, keywords and cross-references

  • AMRFinderPlus (optional, if installed locally): screen your own genomes

All data sources are public domain or freely accessible; no API keys are required.

Example questions

Which carbapenemases are reported in Klebsiella pneumoniae, and what is the original paper for KPC-2?

Give me the protein sequence of mcr-1.1 and its UniProt function annotation.

Run AMRFinderPlus on ~/data/isolate_17.fasta as Escherichia and explain the hits by drug class.

Related MCP server: veupathdb-wdk-mcp

Tools

Tool

What it does

search_amr_genes

Search by text, drug class, subclass, organism or element type

get_amr_gene

Exact record for an allele (blaKPC-2) or summary of a family (blaKPC)

list_drug_classes

Drug classes and how many catalog entries each has

catalog_info

Catalog version and size

fetch_sequence

Protein or nucleotide FASTA from NCBI by accession

get_pubmed_references

Title, journal, authors and DOI for PubMed IDs

search_uniprot / get_uniprot_entry

UniProtKB search and entry details

run_amrfinder

Run a local AMRFinderPlus install on a FASTA file

Installation

Run it with uv (no install step needed), or pip install amr-mcp.

Claude Code

claude mcp add amr -- uvx amr-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "amr": { "command": "uvx", "args": ["amr-mcp"] }
  }
}

Without uv: pipx

pipx install amr-mcp
which amr-mcp   # e.g. /Users/you/.local/bin/amr-mcp

Then use that absolute path as the command, for example in claude_desktop_config.json:

{
  "mcpServers": {
    "amr": { "command": "/Users/you/.local/bin/amr-mcp" }
  }
}

Desktop apps don't inherit your shell's PATH, so if Claude Desktop can't start the server, use the absolute path for the command (this applies to uvx too: run which uvx to get it).

Configuration

Variable

Purpose

NCBI_API_KEY

Optional, free. Raises the NCBI rate limit from 3 to 10 requests/s

NCBI_EMAIL

Optional. Contact e-mail NCBI asks tools to send

AMR_MCP_CACHE_DIR

Where the catalog is cached (default ~/.cache/amr-mcp, refreshed every 30 days)

To enable run_amrfinder: conda install -c bioconda ncbi-amrfinderplus && amrfinder -u.

Development

python -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/pytest -m "not network"   # offline tests
.venv/bin/pytest                    # also hits the live NCBI/UniProt APIs

Data licensing

The NCBI Reference Gene Catalog and NCBI sequence data are US government works in the public domain. UniProt data is available under CC BY 4.0. Please cite the original sources when you publish results:

  • Feldgarden M, et al. AMRFinderPlus and the Reference Gene Catalog facilitate examination of the genomic links among antimicrobial resistance, stress response, and virulence. Sci Rep. 2021.

  • The UniProt Consortium. UniProt: the Universal Protein Knowledgebase. Nucleic Acids Res.

License

MIT


Developed with AI assistance (Claude Code); all code reviewed and tested by the author.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to perform NCBI BLAST sequence similarity searches through natural language, supporting nucleotide and protein searches, custom database creation, and multiple output formats.
    11
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables AI assistants to explore VEuPathDB WDK catalogs, searches, parameters, and gene data, and to perform gene lookups, expression summaries, step estimates, and download URL retrieval using VEuPathDB credentials.
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables querying NCBI genome assemblies, gene details with cross-references, and taxonomy trees with per-node assembly and gene counts, providing structured answers about genomes, genes, and taxonomy.
    381 npm
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to submit genomic sequences or NCBI accessions to antiSMASH for secondary metabolite biosynthetic gene cluster analysis, check job status, retrieve and download results, and query server status across bacteria, fungi, and plant servers.
    10
    1
    MIT