Skip to main content
Glama
ryogena-pubmed-mcp

ryogena-pubmed-mcp

by KyleVick4

ryogena-pubmed-mcp

A small, focused Model Context Protocol server that exposes NCBI PubMed as MCP tools, so any MCP-compatible client (Claude Desktop, Claude Code, custom agents) can search the literature, fetch abstracts, walk the citation graph, and look up an author's publications without leaving the chat.

No API key required. An optional NCBI_API_KEY raises the rate limit from 3 → 10 requests/sec.

Tools

Tool

What it does

search_pubmed(query, max_results, sort)

Free-text or full-syntax PubMed query. Returns title, authors, journal, pubdate, DOI, PubMed URL.

fetch_article(pmid)

Full abstract for one PMID, with section labels preserved (Background / Methods / Results / Conclusions).

find_related(pmid, max_results)

NCBI's "related articles" neighbors — walk the citation graph from any paper.

search_by_author(author, max_results, sort)

Author publication list using the [au] field qualifier.

All tools are read-only; PubMed itself is read-only.

Related MCP server: mcp-pubmed

Install

pip install ryogena-pubmed-mcp

Or from source:

git clone https://github.com/KyleVick4/pubmed-mcp
cd pubmed-mcp
pip install -e .

Configure in Claude Desktop

Edit your claude_desktop_config.json:

{
  "mcpServers": {
    "pubmed": {
      "command": "python",
      "args": ["-m", "pubmed_mcp"],
      "env": {
        "NCBI_API_KEY": "<optional>",
        "NCBI_EMAIL":   "<optional, recommended by NCBI>"
      }
    }
  }
}

Restart Claude Desktop. The pubmed server should show up in the MCP panel with four tools.

Configure in Claude Code

claude mcp add pubmed -- python -m pubmed_mcp

Try it

Once wired up:

Find me the three most-cited papers on JAK2 V617F selectivity from 2023, then pull the abstract of the top hit.

Claude will plan a search_pubmed → fetch_article chain and cite each paper with its DOI and PubMed URL.

Verify the server before debugging your client

Use the MCP Inspector — it's the fastest way to see if the server starts cleanly and the tools register:

npx @modelcontextprotocol/inspector python -m pubmed_mcp

Run the tests

The test suite is hermetic — no NCBI requests, no network. Every HTTP call is intercepted by httpx.MockTransport.

pip install -e ".[dev]"
pytest -v

Why this exists

I built Pico, a closed-source AI-native drug discovery platform, with its own MCP server that exposes molecule and assay tools to Claude Desktop. Building ryogena-pubmed-mcp in the open lets me share the integration patterns I use — slim LLM-friendly projections, hermetic test design, error-envelope contracts — without exposing the domain code.

If you're building an MCP server and want a tiny reference, the server.py and tests/test_tools.py files together are about 500 lines and demonstrate the full pattern.

License

MIT — see LICENSE.

Available Tools

4 tools
fetch_articleA

Fetch one article with full abstract text.

Returns title, abstract (with section labels preserved if structured), authors, journal, pubdate, DOI, and a clickable PubMed URL. Returns {"error": "NOT_FOUND"} if the PMID is invalid.

Inputs: pmid (required). Returns: object

search_by_authorA

Find an author's PubMed-indexed publications.

Wraps search_pubmed with the [au] field qualifier so partial-name matches don't pollute the result. Newest-first by default — flip sort to 'relevance' to surface most-cited / highest-impact first.

Inputs: author (required), sort, max_results. Returns: object

search_pubmedA

Search PubMed and return slim metadata for each hit.

Two-step under the hood: esearch gets PMIDs, esummary gets title/authors/journal/pubdate/DOI for each. Use fetch_article next when you need the full abstract for a specific result.

Inputs: query (required), sort, max_results. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: fetch_article gets full text for a PMID, find_related walks citation neighbors, search_by_author targets author queries, and search_pubmed does general search. No overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with underscores: fetch_article, find_related, search_by_author, search_pubmed. Verbs are descriptive and nouns are specific.

    Tool Count5/5

    Four tools cover the core PubMed operations (search, fetch, related articles) without unnecessary duplication. The number is within the recommended 3-15 range and well-scoped for the purpose.

    Completeness4/5

    The tool set covers the main workflows: searching (general and by author), fetching full articles, and exploring related papers. Minor gaps exist, such as search by topic/MeSH or filtering by date, but agents can accomplish common tasks without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides comprehensive access to NCBI's PubMed database of over 36 million biomedical citations, allowing users to search, retrieve, and analyze literature directly through MCP tools. It supports advanced queries, citation management, full-text retrieval from PubMed Central, and precise discovery using MeSH terms.
      16
      15
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides advanced PubMed literature search, retrieval of article details and abstracts, citation export in multiple formats, author and MeSH term searches, related article discovery, journal analysis, and research trend analysis through the Model Context Protocol.
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables searching PubMed and Europe PMC, fetching article metadata and full text with fallbacks, resolving citations and IDs, formatting references, and looking up MeSH terms via MCP over STDIO or Streamable HTTP.
      9 npm
      MIT