PuRe MPG MCP Server
Toymen/pure-mpg-mcp
Busque e analise publicações Max Planck com enriquecimento de dados acadêmicos
Ver no GitHubServidor MCP para a API REST do PuRe (PubMan) da Max Planck Society, permitindo busca e análise de publicações acadêmicas com enriquecimento de dados via OpenAlex, Crossref, Unpaywall e outras fontes públicas. Integra ferramentas de pesquisa bibliográfica, análise de autoria e métricas de citação em um único servidor leve e sem autenticação.
Instalação
npx convez-ai Toymen/pure-mpg-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Pesquisa bibliográfica avançada em repositório institucional
- Análise de padrões de coautoria e colaboração entre pesquisadores
- Coleta de métricas de citação e análise de impacto de publicações
Veredito

MCP bem estruturado para quem trabalha com dados acadêmicos e bibliometria. A integração com múltiplas fontes públicas (OpenAlex, Crossref, Unpaywall) oferece valor real sem depender de credenciais privadas, ideal para pesquisadores e analistas de dados científicos.
README
A tradução para o português deste README ainda está na fila.
pure-mpg-mcp
An MCP server for the PuRe (PubMan) REST API — the Max Planck Society's publication repository at pure.mpg.de.
It lets any MCP client (Claude Desktop, Claude Code, etc.) search and retrieve Max Planck publications, organizational units, collections, and feeds.
Public & read-only. This server is anonymous: it only reaches
RELEASED, publicly visible records. It does not log in, write, or access embargoed/private content. The PuRe write/curation/admin endpoints require authorization and are intentionally not exposed.
PuRe is the center. Every tool starts from a PuRe record. A few tools enrich that record with other free public scholarly APIs (CONE, OpenAlex, Crossref, Unpaywall, Semantic Scholar), but always keyed on identifiers PuRe itself provides (DOI, person ids). The external sources are enrichment only — never queried on their own, never the canonical record.
Tools
Search & retrieval
| Tool | What it does |
|---|---|
search_publications | Search by free text, author, genre, and year (compact results) |
search_raw | Run a raw Elasticsearch query for advanced cases |
get_publication | Full metadata for one item id (e.g. item_1552993) |
find_by_doi | Look up a publication by DOI (bare or doi.org URL) |
export_publication | Export as BibTeX, citation, MARC, EndNote, … |
get_file_metadata | Metadata for an attached file (component) |
search_organizations | Search institutes / departments (organizational units) |
list_top_organizations | Top-level organizational units |
search_collections | Search contexts (collections) |
recent_publications | Feed of recently released items |
open_access_feed | Feed of recent open-access items |
service_info | Version / status of the PuRe instance |
Authority & analysis (for bibliometrics)
| Tool | What it does |
|---|---|
resolve_author | Resolve a name/person-id against the CONE authority → full name, affiliation, ORCID. Expands initials. |
author_publications | List an author's publications (by CONE id or family name) |
publication_statistics | Distributions over a result set: by year, genre, language, organization, or open_access |
coauthorship_analysis | Collaboration patterns: avg team size, solo-authored count, top co-authors & institutions |
analyze_authors | Extract & enrich authors of a publication/query — full names (initials expanded via CONE), ORCID, affiliation |
External enrichment (PuRe DOI → public scholarly APIs)
| Tool | What it does |
|---|---|
enrich_publication | Attach external signals to a PuRe item: citations, topics, institutions (ROR), funders, license, OA full text. Pick sources from openalex, crossref, unpaywall, semanticscholar |
get_citation_metrics | Citation counts for one publication side-by-side across OpenAlex, Crossref, and Semantic Scholar (incl. influential citations) |
find_full_text | Locate free full text — PuRe's own public files first, then Unpaywall / OpenAlex open-access locations |
Enrichment sources
All are free and require no authentication. They are queried only with an identifier taken from a PuRe record, and any source lacking that record is silently omitted.
| Source | Adds | Notes |
|---|---|---|
| CONE | Full author names, ORCID, affiliation | MPG's own authority service |
| OpenAlex | Citation count, topics, institutions/ROR, OA status, related works | No key |
| Crossref | References, funders, license, citing count | No key |
| Unpaywall | Definitive OA status + free full-text PDF | Requires a contact email |
| Semantic Scholar | Influential-citation count, TLDR summary | No key; rate-limited |
Citation counts differ across sources because each indexes a different corpus — that's expected, and why get_citation_metrics shows them side by side rather than picking one.
Note on analytics. PuRe's search endpoint strips Elasticsearch aggregations, so
publication_statisticsandcoauthorship_analysisfetch a capped sample of records (scrolled, default 300–500) and aggregate client-side. WhennumberOfRecordsexceeds the cap, treat the figures as sample-based, and raisemax_recordsif you need more (at the cost of more requests).
Use with Claude
The server is on PyPI, so no cloning or building is needed — clients run it
on demand with uvx.
Prerequisite: install uv (provides uvx):
curl -LsSf https://astral.sh/uv/install.sh | sh # macOS/Linux
# Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
Claude Code
One command:
claude mcp add pure-mpg -- uvx pure-mpg-mcp
To enable the Unpaywall full-text source as well, pass a real contact email:
claude mcp add pure-mpg -e PURE_CONTACT_EMAIL=you@example.org -- uvx pure-mpg-mcp
Claude Desktop
Edit claude_desktop_config.json (Settings → Developer → Edit Config, or):
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"pure-mpg": {
"command": "uvx",
"args": ["pure-mpg-mcp"],
"env": { "PURE_CONTACT_EMAIL": "you@example.org" }
}
}
}
Then fully quit and reopen Claude Desktop (closing the window isn't enough).
The env block is optional — it only enables the Unpaywall source.
Remote connector by URL (no local install)
If you can't run it locally, host it once and add it to Claude as a custom connector by URL — works in Claude Desktop and claude.ai (web), on Free/Pro/ Max/Team/Enterprise. No OAuth is required because the server is public and read-only.
The same server speaks Streamable HTTP at /mcp when MCP_TRANSPORT=http is
set. A Dockerfile is included; pick whichever host you like.
Option A — Render (render.yaml, one-click):
go to render.com → New → Blueprint → pick this repo.
Render builds the container and your URL is https://<service>.onrender.com/mcp.
(Render auto-sets RENDER_EXTERNAL_HOSTNAME, which the server trusts as an
allowed host. Free tier sleeps after ~15 min idle → slow first request.)
Option B — self-hosted, fully open source (compose.yaml +
Caddyfile): runs the container behind Caddy
(Apache-2.0), which gets HTTPS automatically via Let's Encrypt. Needs any VPS or
home server and a domain pointing at it:
git clone https://github.com/Toymen/pure-mpg-mcp.git && cd pure-mpg-mcp
cp .env.example .env # set MCP_DOMAIN to your domain
docker compose up -d --build # or: podman-compose up -d --build
URL: https://<MCP_DOMAIN>/mcp. Open-source PaaS like Coolify,
Dokku, or CapRover work too — they
build the same Dockerfile.
Host allow-list. The MCP SDK has DNS-rebinding protection that trusts only localhost. The server auto-trusts Render's hostname; on any other host set
MCP_ALLOWED_HOSTSto your domain (comma-separated). If neither is set, protection is disabled — acceptable here since the server is public, read-only, and unauthenticated.
Add it in Claude: Settings → Connectors → Add custom connector →
paste the …/mcp URL → Transport: Streamable HTTP → Add.
From source (development)
git clone https://github.com/Toymen/pure-mpg-mcp.git
cd pure-mpg-mcp
uv pip install -e ".[dev]"
Configuration
| Env var | Default | Purpose |
|---|---|---|
PURE_BASE_URL | https://pure.mpg.de/rest | Override the API base (e.g. a QA instance) |
PURE_CONE_URL | https://pure.mpg.de/cone | Override the CONE authority base |
PURE_CONTACT_EMAIL | (unset) | A real contact email. Used for the OpenAlex/Crossref "polite pool", and required by Unpaywall — find_full_text and enrich_publication skip the Unpaywall source (and say so) until this is set. @example.com addresses are treated as unset. |
MCP_TRANSPORT | stdio | Set to http to serve Streamable HTTP at /mcp (for remote hosting) instead of stdio. |
PORT / HOST | 8000 / 0.0.0.0 | Bind address in HTTP mode (most hosts inject PORT). |
MCP_ALLOWED_HOSTS | (unset) | Comma-separated hostnames to trust in HTTP mode (DNS-rebinding protection). Render's hostname is trusted automatically. |
Example
"Find recent open-access articles from the Max Planck Institute for Evolutionary Anthropology about Neanderthals, and give me the BibTeX for the top hit."
The agent calls search_publications(text="Neanderthal", genre="ARTICLE"),
then export_publication(item_id, format="BibTex").
Development
uv pip install -e ".[dev]"
ruff check .
pytest -m "not network" # offline unit tests (what CI runs)
pytest # include live API smoke tests (network)
Tests are split with a network marker: offline tests cover all the pure
aggregation/parsing logic and run in CI; network-marked tests hit the live
public APIs and are skipped in CI so the suite never depends on third-party
uptime or rate limits. GitHub Actions runs lint + offline tests on Python 3.10
and 3.12 (.github/workflows/ci.yml).
Releases & publishing
Versioning and changelogs are automated with release-please from Conventional Commits — see CONTRIBUTING.md. The flow:
- Land Conventional Commits on
main(feat:,fix:, …). - release-please opens a release PR that bumps the version across
pyproject.toml,src/pure_mpg_mcp/__init__.py, andserver.json, and updatesCHANGELOG.md(.github/workflows/release-please.yml). - Merge the release PR → the tag and GitHub Release are created, and the package is built and pushed to PyPI via Trusted Publishing (OIDC, no stored token). No manual tagging.
MCP servers aren't "hosted" on GitHub — GitHub holds the source, PyPI ships the
package (uvx pure-mpg-mcp), and clients launch it locally over stdio. For
discovery, the optional MCP Registry uses server.json as
its manifest; the <!-- mcp-name: io.github.toymen/pure-mpg-mcp --> line in
this README verifies ownership. Publish it with the
mcp-publisher CLI once
a PyPI release exists.
.github/workflows/publish.ymlremains as a fallback that publishes any manually created GitHub Release.
API reference
- Swagger UI: https://pure.mpg.de/rest/swagger-ui/index.html
- OpenAPI spec: https://pure.mpg.de/rest/v3/api-docs
- PubMan REST docs: https://colab.mpdl.mpg.de/mediawiki/PubMan_REST_API_Documentation
License
MIT. This project is an independent client and is not affiliated with or endorsed by the Max Planck Society / Max Planck Digital Library.