Skip to main content

An MCP server that provides access to PubMed articles through Entrez API.

Project description

MCP Simple PubMed

smithery badge

An MCP server that provides access to PubMed articles through the Entrez API.

mcp-simple-pubmed MCP server

Features

  • Search PubMed database using keywords
  • Access article abstracts
  • Download full text when available (for open access articles available directly on PubMed)

Please note that the tool returns XML-ized version of full text. It is however more useful for AIs than a "human readable" text would have been as it gives them additional information about document's structure. At least, this is what Claude 3.5 Sonnet said he prefers.

Please also note that inability of this tool and possibly other tools to deliver a paper's full text may not be due to the fact that it is not available. When testing this tool I came across a paper that did not have full text on PubMed and when Claude accessed the publication URL (which we did get through DOI) using fetch he did get a "forbidden” error. However, I was able to access the very same page using a regular browser.

In other words if your AI assistant is not able to get the full text of a paper using this tool it is worth trying manually with a regular web browser.

Finally, this tool of course can’t give you access to paywalled/paid papers. You may be able to read them through your library access or – as a last resort – through a certain site that strives to make publicly funded research freely available.

Installation

Installing via Smithery

To install Simple PubMed for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-simple-pubmed --client claude

Manual Installation

pip install mcp-simple-pubmed

Configuration

The server requires the following environment variables:

  • PUBMED_EMAIL: Your email address (required by NCBI)
  • PUBMED_API_KEY: Optional API key for higher rate limits

The standard rate limit is 3 requests / second. No rate limiting was implemented, as it is highly unlikely in the typical usage scenario that your AI would generate more traffic. If you need it, you can register for an API key which will give you 10 requests / second. Read about this on NCBI pages.

Usage with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

(Mac OS)

{
  "mcpServers": {
    "simple-pubmed": {
      "command": "python",
      "args": ["-m", "mcp_simple_pubmed"],
      "env": {
        "PUBMED_EMAIL": "your-email@example.com",
        "PUBMED_API_KEY": "your-api-key" 
      }
    }
  }
}

(Windows)

{
  "mcpServers": {
    "simple-pubmed": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
      "args": [
        "-m",
        "mcp_simple_pubmed"
      ],
      "env": {
        "PUBMED_EMAIL": "your-email@example.com",
        "PUBMED_API_KEY": "your-api-key" 
      }
    }
  }
}

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mseep_mcp_simple_pubmed-0.1.11.tar.gz (13.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mseep_mcp_simple_pubmed-0.1.11-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

Details for the file mseep_mcp_simple_pubmed-0.1.11.tar.gz.

File metadata

  • Download URL: mseep_mcp_simple_pubmed-0.1.11.tar.gz
  • Upload date:
  • Size: 13.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.12

File hashes

Hashes for mseep_mcp_simple_pubmed-0.1.11.tar.gz
Algorithm Hash digest
SHA256 7fddd98c088b7929befd3fea34740bd0a3edc151518d9bfd0a0681641b02a842
MD5 42b16a6130fae7a4912c67fb01b18e0f
BLAKE2b-256 5d4bc73a091f424b85a0c7e0b04f92a6193b53f6e69fc9534703140dc9566eea

See more details on using hashes here.

File details

Details for the file mseep_mcp_simple_pubmed-0.1.11-py3-none-any.whl.

File metadata

File hashes

Hashes for mseep_mcp_simple_pubmed-0.1.11-py3-none-any.whl
Algorithm Hash digest
SHA256 017264368bce72ea60eef066513e315c992b261531248eb039d785e226159c96
MD5 915b50551841f784bdaf85c3f5fb60bd
BLAKE2b-256 90aeb2d83b0b1d85305f9f46c51d63083bc4574388014b2cc40bd9c595c27023

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page