NCBI Literature Search MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/vitorpavinato/ncbi-mcp-server
cd ncbi-mcp-server

Then follow the repository README for any remaining dependency or build steps before continuing.

2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add ncbi-literature-search -- node "<FULL_PATH_TO_NCBI_MCP_SERVER>/dist/index.js"

Replace <FULL_PATH_TO_NCBI_MCP_SERVER>/dist/index.js with the actual folder you prepared in step 1.

README.md

Search PubMed's 35+ million articles through natural language queries

NCBI Literature Search MCP Server

A Model Context Protocol (MCP) server for searching NCBI databases, designed for researchers across all life sciences and biomedical fields. This server provides seamless access to PubMed's vast collection of 35+ million scientific articles through natural language queries, enabling AI assistants to help with literature reviews, research discovery, and scientific analysis.

Features

šŸ”¬ Comprehensive Search: Search PubMed's 35+ million articles across all biological disciplines šŸ“Š Advanced Queries: Support for complex searches with boolean operators, field tags, and filters
🧬 Life Sciences Research: Covers all biological and biomedical fields including genetics, ecology, medicine, and biotechnology šŸ’» Computational Biology: Perfect for finding bioinformatics methods, algorithms, and computational tools šŸ”¬ Research Applications: Literature reviews, hypothesis generation, method discovery, and staying current with scientific advances šŸ“š Full Article Details: Get abstracts, author lists, MeSH terms, DOIs, and publication information šŸ”— Related Articles: Discover relevant research through NCBI's relationship algorithms šŸ“– MeSH Integration: Search and utilize Medical Subject Headings for precise terminology

Quick Start

Prerequisites

Setup (5 minutes)

  1. Create and initialize project

    mkdir ncbi-mcp-server && cd ncbi-mcp-server
    poetry init
    

    During init, add dependencies: mcp, httpx, typing-extensions

  2. Create project structure

    mkdir -p src/ncbi_mcp_server
    # Save server.py code as src/ncbi_mcp_server/server.py
    
  3. Install dependencies

    poetry install
    
  4. Test the server

    poetry run python src/ncbi_mcp_server/server.py
    
  5. Configure Claude Desktop

    Edit your Claude Desktop config file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%/Claude/claude_desktop_config.json
    • Linux: ~/.config/claude/claude_desktop_config.json

    Add this configuration:

    {
      "mcpServers": {
        "ncbi-literature": {
          "command": "poetry",
          "args": ["run", "python", "src/ncbi_mcp_server/server.py"],
          "cwd": "/FULL/PATH/TO/YOUR/ncbi-mcp-server"
        }
      }
    }
    
  6. Restart Claude Desktop and start searching!

Alternative Setup Methods

Click to expand alternative installation methods
**Conda Environment**
conda env create -f environment.yml
conda activate ncbi-mcp
python server.py
**Standard pip + venv**
python -m venv venv
source venv/bin/activate  # Linux/macOS
pip install -r requirements.txt
python server.py

Usage Examples

For Evolutionary Biology Research

Search for phylogenetic studies:

"Search for recent phylogenetic analysis papers on mammalian evolution"
→ Uses: search_pubmed with query "phylogenetic analysis[ti] AND mammalian[ti] AND evolution"

Find computational phylogenetics methods:

"Find papers about maximum likelihood methods for phylogenetic reconstruction"
→ Uses: search_pubmed with query "maximum likelihood[ti] AND phylogenetic reconstruction"

Search by specific organism:

"Find recent papers on Drosophila comparative genomics"
→ Uses: search_pubmed with query "Drosophila[ti] AND comparative genomics[ti]"

For Computational Biology Research

Algorithm and method papers:

"Search for machine learning applications in genomics from the last 2 years"
→ Uses: search_pubmed with date_range="730" and query "machine learning AND genomics"

Software and database papers:

"Find papers about new bioinformatics tools for sequence analysis"
→ Uses: search_pubmed with query "bioinformatics[ti] AND software[ti] AND sequence analysis"

Advanced Search Examples

Multi-criteria search:

"Find review articles about CRISPR applications in evolutionary studies published in Nature or Science"
→ Uses: advanced_search with terms=["CRISPR", "evolution"], publication_types=["Review"], journals=["Nature", "Science"]

Author-specific searches:

"Find recent papers by researchers working on ancient DNA and phylogenomics"
→ Uses: search_pubmed with query "ancient DNA[ti] AND phylogenomics[ti]"

Tool Reference

`search_pubmed`

Primary search tool for PubMed database

  • query: Search terms (supports field tags like [ti] for title, [au] for author, [mh] for MeSH terms)
  • max_results: Number of results (1-100, default: 20)
  • sort: Sort by "relevance", "pub_date", "author", or "journal"
  • date_range: Limit to recent articles ("30", "90", "365", "1095" days)

Examples:

  • "CRISPR[ti] AND evolution" - CRISPR

Tools (1)

search_pubmedPrimary search tool for PubMed database

Configuration

claude_desktop_config.json
{"mcpServers": {"ncbi-literature": {"command": "poetry", "args": ["run", "python", "src/ncbi_mcp_server/server.py"], "cwd": "/FULL/PATH/TO/YOUR/ncbi-mcp-server"}}}

Try it

→Search for recent phylogenetic analysis papers on mammalian evolution
→Find papers about machine learning applications in genomics from the last 2 years
→Find review articles about CRISPR applications in evolutionary studies published in Nature or Science
→Find recent papers by researchers working on ancient DNA and phylogenomics

Frequently Asked Questions

What are the key features of NCBI Literature Search?

Search PubMed's 35+ million articles across all biological disciplines. Support for complex searches with boolean operators, field tags, and filters. Retrieve full article details including abstracts, author lists, and MeSH terms. Discover relevant research through NCBI's relationship algorithms. Search and utilize Medical Subject Headings for precise terminology.

What can I use NCBI Literature Search for?

Conducting rapid literature reviews for life sciences and biomedical research. Generating hypotheses by discovering relevant research papers and methods. Finding bioinformatics tools and algorithms for computational biology projects. Staying current with scientific advances in specific fields like genetics or biotechnology.

How do I install NCBI Literature Search?

Install NCBI Literature Search by running: poetry run python src/ncbi_mcp_server/server.py

What MCP clients work with NCBI Literature Search?

NCBI Literature Search works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep NCBI Literature Search docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare