convez.ai
MCP ServerBusca & PesquisaIntermediário
Toymen

PuRe MPG MCP Server

Toymen/pure-mpg-mcp

Busque e analise publicações Max Planck com enriquecimento de dados acadêmicos

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-mcp

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 1 mês
Versão
pure-mpg-mcp-v0.1.5
Issues abertas
0
Contribuidores
1

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

PyPI CI License: MIT

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

ToolWhat it does
search_publicationsSearch by free text, author, genre, and year (compact results)
search_rawRun a raw Elasticsearch query for advanced cases
get_publicationFull metadata for one item id (e.g. item_1552993)
find_by_doiLook up a publication by DOI (bare or doi.org URL)
export_publicationExport as BibTeX, citation, MARC, EndNote, …
get_file_metadataMetadata for an attached file (component)
search_organizationsSearch institutes / departments (organizational units)
list_top_organizationsTop-level organizational units
search_collectionsSearch contexts (collections)
recent_publicationsFeed of recently released items
open_access_feedFeed of recent open-access items
service_infoVersion / status of the PuRe instance

Authority & analysis (for bibliometrics)

ToolWhat it does
resolve_authorResolve a name/person-id against the CONE authority → full name, affiliation, ORCID. Expands initials.
author_publicationsList an author's publications (by CONE id or family name)
publication_statisticsDistributions over a result set: by year, genre, language, organization, or open_access
coauthorship_analysisCollaboration patterns: avg team size, solo-authored count, top co-authors & institutions
analyze_authorsExtract & enrich authors of a publication/query — full names (initials expanded via CONE), ORCID, affiliation

External enrichment (PuRe DOI → public scholarly APIs)

ToolWhat it does
enrich_publicationAttach external signals to a PuRe item: citations, topics, institutions (ROR), funders, license, OA full text. Pick sources from openalex, crossref, unpaywall, semanticscholar
get_citation_metricsCitation counts for one publication side-by-side across OpenAlex, Crossref, and Semantic Scholar (incl. influential citations)
find_full_textLocate 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.

SourceAddsNotes
CONEFull author names, ORCID, affiliationMPG's own authority service
OpenAlexCitation count, topics, institutions/ROR, OA status, related worksNo key
CrossrefReferences, funders, license, citing countNo key
UnpaywallDefinitive OA status + free full-text PDFRequires a contact email
Semantic ScholarInfluential-citation count, TLDR summaryNo 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_statistics and coauthorship_analysis fetch a capped sample of records (scrolled, default 300–500) and aggregate client-side. When numberOfRecords exceeds the cap, treat the figures as sample-based, and raise max_records if 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_HOSTS to 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 varDefaultPurpose
PURE_BASE_URLhttps://pure.mpg.de/restOverride the API base (e.g. a QA instance)
PURE_CONE_URLhttps://pure.mpg.de/coneOverride 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_TRANSPORTstdioSet to http to serve Streamable HTTP at /mcp (for remote hosting) instead of stdio.
PORT / HOST8000 / 0.0.0.0Bind 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:

  1. Land Conventional Commits on main (feat:, fix:, …).
  2. release-please opens a release PR that bumps the version across pyproject.toml, src/pure_mpg_mcp/__init__.py, and server.json, and updates CHANGELOG.md (.github/workflows/release-please.yml).
  3. 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.yml remains as a fallback that publishes any manually created GitHub Release.

API reference

License

MIT. This project is an independent client and is not affiliated with or endorsed by the Max Planck Society / Max Planck Digital Library.

Ver o original no GitHub

Bom para

Relacionados