Skip to main content

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

Project description

MseeP Badge

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.12.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.12-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mseep_mcp_simple_pubmed-0.1.12.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.12.tar.gz
Algorithm Hash digest
SHA256 8e6176d01990512a29dcc83b33819d364aa1040bc0d05e1971234dfc91d035ff
MD5 693c18607a58157fa325f79a4172c4e4
BLAKE2b-256 b958d991ef7f5ee18b0541d678fbf46b452faa1f238ba758c85aaa55c026c33e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mseep_mcp_simple_pubmed-0.1.12-py3-none-any.whl
Algorithm Hash digest
SHA256 bdf8042c631fdbdd0fda08c15b2f8730935e8a8856d87c7677c52600826ef973
MD5 b47f04d655b836f8301919e4d1772d78
BLAKE2b-256 ded6f109f0a39254d0f569476f4fca81fabd17c5e602fbcf9aae18252a2b1f6e

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