Skip to main content
Glama

NMDC-MCP

MCP (Model Context Protocol) Server for the National Microbiology Data Center (NMDC) of China.

Python 3.10+ MCP License: MIT Version

Overview

NMDC-MCP is a Model Context Protocol (MCP) server that provides AI applications with access to the data and services of the National Microbiology Data Center (NMDC) — China's national-level data center for microbiology research. The server exposes NMDC's rich data resources through a standardized MCP interface, enabling AI assistants like Claude, ChatGPT, and others to search, query, and explore microbiology data.

What is NMDC?

The National Microbiology Data Center (国家微生物科学数据中心) is hosted by the Institute of Microbiology, Chinese Academy of Sciences. It provides comprehensive microbiology data services including:

  • Microbiome Data — BioProjects, BioSamples, Nucleotides, Metagenomes, Genomes, Proteins, SRA, and more

  • Microbial Resources — Global Catalogue of Microorganisms (GCM), biological parts

  • Virus Data — Virus pathogen sequences, SARS-CoV-2 genome and variation data

  • Pathogen Data — Pathogen catalogues, plasmids, phage, tuberculosis data

  • Fungi Data — Fungal names, genomes, type specimens

  • Microbial Dictionary — Biological terms, DNA barcodes

  • Microbial Catalog — Global microbial names, Chinese fungal specimens

What is MCP?

The Model Context Protocol is an open standard for connecting AI applications to external systems. It provides a unified way for AI assistants to access data sources, tools, and workflows.

Related MCP server: datamgr

Features

  • 🔬 19 MCP Tools covering all major NMDC data categories

  • 📚 5 MCP Resources for structured data access

  • 🔄 Resource Templates for dynamic URI-based access

  • 🌐 Async HTTP Client for efficient NMDC API communication

  • ⚙️ Configurable via environment variables

  • 📦 Easy Installation via pip or uv

Quick Start

Installation

# Using pip
pip install nmdc-mcp

# Or using uv
uv pip install nmdc-mcp

# Or from source
git clone https://github.com/zengzichao/NMDC-MCP.git
cd NMDC-MCP
pip install -e .

Configuration

Add the NMDC-MCP server to your MCP client configuration:

Claude Desktop / Claude Code

{
  "mcpServers": {
    "nmdc": {
      "command": "nmdc-mcp",
      "env": {
        "NMDC_BASE_URL": "https://nmdc.cn"
      }
    }
  }
}

Cursor / VS Code

{
  "mcp.servers": {
    "nmdc": {
      "command": "nmdc-mcp"
    }
  }
}

Usage

Once configured, you can ask your AI assistant to interact with NMDC data:

Search NMDC for E. coli genome data
What analysis tools are available on NMDC?
Look up the BioProject PRJCA000001 on NMDC
Search the microbial dictionary for "bacteriophage"

Available Tools

Tool

Description

search_nmdc_data

Search across all NMDC databases by keyword

get_nmdc_data_overview

Get overview of all available data resources

get_bioproject

Get BioProject details by accession ID

get_biosample

Get BioSample details by accession ID

get_sequence

Get sequence information by accession ID

search_genome

Search genome records

search_sra

Search Sequence Read Archive data

search_metagenome

Search metagenome data

search_virus

Search virus pathogen data

search_ncov_variation

Search SARS-CoV-2 variation data

search_fungi

Search fungi microorganism data

search_pathogen

Search pathogen microorganism data

search_tuberculosis

Search tuberculosis data

search_gcm

Search Global Catalogue of Microorganisms

search_microbial_dictionary

Search microbial dictionary for terms

search_microbial_catalog

Search microbial catalog

get_analysis_tools

Get available analysis tools

get_metadata_standards

Get metadata standards information

get_download_list

Get downloadable dataset list

Configuration Options

Environment Variable

Default

Description

NMDC_BASE_URL

https://nmdc.cn

NMDC website base URL

NMDC_API_BASE_URL

https://nmdc.cn/api

NMDC API base URL

NMDC_TIMEOUT

30.0

HTTP request timeout (seconds)

NMDC_MAX_RESULTS

50

Maximum results per query

NMDC_PAGE_SIZE

20

Default page size for pagination

Development

Setup Development Environment

git clone https://github.com/zengzichao/NMDC-MCP.git
cd NMDC-MCP
pip install -e ".[dev]"

Run Tests

pytest

Lint and Type Check

ruff check src/
mypy src/

Documentation

License

This project is licensed under the MIT License.

Acknowledgments

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    An MCP server that gives AI assistants access to biological and biomedical RDF databases via SPARQL at the RDF Portal, as well as selected REST APIs (NCBI E-utilities, UniProt, ChEMBL, PDB, Reactome, Rhea, MeSH, and more).
    2
    29
    20
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to discover and inspect research datasets via a read-only MCP server, offering search, variable listing, and metadata retrieval without reading data files.
    -
  • A
    license
    A
    quality
    B
    maintenance
    Enables researchers to query public ENA and BioSamples genomics data in plain English through any MCP client, including counting records, searching samples, retrieving sample details, and checking metadata quality against project requirements.
    4
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants and autonomous agents to search, browse, and retrieve podcast and episode information from the Podcast Index through a standardized MCP interface.
    Apache 2.0