Back to Browse

Amr MCP Server

Developer ToolsLow Risk8.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Antimicrobial resistance genes, sequences and literature from NCBI and UniProt

About

Antimicrobial resistance genes, sequences and literature from NCBI and UniProt

Security Report

8.0
Low Risk8.0Low Risk

Valid MCP server (1 strong, 3 medium validity signals). 4 known CVEs in dependencies Package registry verified. Imported from the Official MCP Registry.

12 files analyzed · 5 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Optional free NCBI API key; raises the rate limit from 3 to 10 requests/sRequired

Environment variable: NCBI_API_KEY

Optional contact e-mail sent to NCBI with each requestOptional

Environment variable: NCBI_EMAIL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "amr-mcp": {
      "command": "uvx",
      "args": [
        "amr-mcp==0.1.4"
      ],
      "env": {
        "NCBI_EMAIL": "your-ncbi-email-here",
        "NCBI_API_KEY": "your-ncbi-api-key-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

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.

Demo

Claude Code answering the first example question below: the server looks up blaKPC-2 in the catalog, counts the species NCBI has found it in, pulls the protein sequence and resolves the original paper.

amr-mcp answering a question about the KPC-2 carbapenemase

Example questions

Which species carry the KPC-2 carbapenemase, what is the original paper describing it, and what does its protein sequence look like?

Summarise the carbapenemase gene families in the catalog and how many variants each has.

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.

Tools

ToolWhat it does
search_amr_genesSearch by text, drug class, subclass, organism or element type; group_by_family for broad searches
get_amr_geneExact record for an allele (blaKPC-2) or summary of a family (blaKPC)
list_drug_classesDrug classes and how many catalog entries each has
catalog_infoCatalog version and size
fetch_sequenceProtein or nucleotide FASTA from NCBI by accession
get_protein_hostsSpecies in which NCBI has sequenced an exact protein (Identical Protein Groups)
get_pubmed_referencesTitle, journal, authors and DOI for PubMed IDs
search_uniprot / get_uniprot_entryUniProtKB search and entry details
run_amrfinderRun 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).

Agent skill (optional)

skills/amr-research/SKILL.md tells the agent when to reach for these tools and how to chain them (gene → hosts → sequence → paper, family overviews, genome screening), plus the pitfalls to avoid. It works with any agent that reads SKILL.md files (Claude Code, Cursor, Codex, Copilot…):

npx skills add pabloestepaa/amr-mcp

Or copy the folder by hand, e.g. to ~/.claude/skills/amr-research/ for Claude Code. The skill uses the MCP server above, so install that too.

Configuration

VariablePurpose
NCBI_API_KEYOptional, free. Raises the NCBI rate limit from 3 to 10 requests/s
NCBI_EMAILOptional. Contact e-mail NCBI asks tools to send
AMR_MCP_CACHE_DIRWhere 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.

Reviews

No reviews yet

Be the first to review this server!