pubmed-lib 1.0.0

PubMed search, fetch, and parse library with optional MCP server for AI agents

pubmed-lib

PubMed search, fetch, and parse for Python apps and AI agents.

MCP quickstart

uv add "pubmed-lib[mcp]"
export ENTREZ_EMAIL=[e-mail]
pubmed-mcp

Add to Cursor mcp.json (local repo — adjust path):

{
  "mcpServers": {
    "pubmed": {
      "command": "uv",
      "args": ["--directory", "/Users/matu/Xcode/pubmed_lib", "run", "pubmed-mcp"],
      "env": {
        "ENTREZ_EMAIL": "[e-mail]"
      }
    }
  }
}

After PyPI publish, you can use "command": "uvx", "args": ["pubmed-mcp"] instead.

Remote SSE:

MCP_API_KEY=<32+ chars> ENTREZ_EMAIL=[e-mail] \
  pubmed-mcp --transport sse --port 8000

See docs/mcp.md for tool reference and security notes.

Python library

uv add pubmed-lib

from pubmed_lib import PubMedClient

client = PubMedClient(email="[e-mail]")
response = client.search_articles("diabetes", max_results=5)
for article in response.articles:
    print(article.summary)

See docs/library.md and docs/models.md.

Development

uv sync --all-extras --dev
uv run pytest

See docs/contributing.md and MIGRATION.md.

License

Apache-2.0