# Scholar MCP

> FastMCP server for scholarly papers, patents, books and standards with docling PDF conversion

- name: io.github.pvliesdonk/scholar-mcp
- version: 2.0.0
- connection class: L0 (run_local_package)
- trust: 90/100
- quality: –/100 (not scored)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.pvliesdonk%2Fscholar-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.pvliesdonk%2Fscholar-mcp/tools

**Runs on your machine: something must execute the package.** Only local packages are published (npm, PyPI, OCI, …). The registry never executes them, so tools are unknown until you run it.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "scholar-mcp": {
      "command": "uvx",
      "args": [
        "pvliesdonk-scholar-mcp==2.0.0"
      ],
      "env": {
        "SCHOLAR_MCP_KV_STORE_URL": "file:///data/state",
        "FASTMCP_LOG_LEVEL": "INFO",
        "FASTMCP_ENABLE_RICH_LOGGING": "true",
        "SCHOLAR_GITHUB_TOKEN": "${SCHOLAR_GITHUB_TOKEN}",
        "SCHOLAR_MCP_READ_ONLY": "true",
        "SCHOLAR_MCP_S2_API_KEY": "${SCHOLAR_MCP_S2_API_KEY}",
        "SCHOLAR_MCP_VLM_API_KEY": "${SCHOLAR_MCP_VLM_API_KEY}",
        "SCHOLAR_MCP_VLM_MODEL": "gpt-4o",
        "SCHOLAR_MCP_CACHE_DIR": "/data/scholar-mcp",
        "SCHOLAR_MCP_EPO_CONSUMER_SECRET": "${SCHOLAR_MCP_EPO_CONSUMER_SECRET}",
        "SCHOLAR_MCP_GOOGLE_BOOKS_API_KEY": "${SCHOLAR_MCP_GOOGLE_BOOKS_API_KEY}",
        "SCHOLAR_MCP_JOBS_SOFT_DEADLINE_S": "25.0",
        "SCHOLAR_MCP_JOBS_RESULT_TTL_S": "3600.0",
        "SCHOLAR_MCP_JOBS_MAX_PER_SUBJECT": "256"
      }
    }
  }
}
```

Placeholders to fill: `${SCHOLAR_GITHUB_TOKEN}`, `${SCHOLAR_MCP_S2_API_KEY}`, `${SCHOLAR_MCP_VLM_API_KEY}`, `${SCHOLAR_MCP_EPO_CONSUMER_SECRET}`, `${SCHOLAR_MCP_GOOGLE_BOOKS_API_KEY}`.

## Trust

- hygiene: 95
- liveness: n/a
- freshness: 85
- provenance: 90
- drivers: +repository +namespace-matches-repo +website ~liveness-unmeasured ~updated-40d-ago -unpinned-packages(1)
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality –/100 (not scored)

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

### protocol: n/a (weight 25)

- n/a `protocol.modern`, `protocol.stateless`, `protocol.transport`, `protocol.list_ttl`: no remote answered a protocol handshake (not probed yet, unreachable, or local-only)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: n/a (weight 30)

- n/a `tools.descriptions`, `tools.description_length`, `tools.schemas`, `tools.annotations`, `tools.directory_hints`, `tools.token_cost`, `tools.api_dump`: tool list unknown (behind auth, not probed, or empty)

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool list unknown

### dependencies: 100 (weight 15)

- pass `deps.known_vulns`: no known advisory in 98 resolved packages
- pass `deps.mcp_sdk_version`: mcp 2.2.0, no known advisory
- pass `deps.resolvable`: pvliesdonk-scholar-mcp@2.0.0 resolved: 98 packages

- tools: unknown
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.pvliesdonk/scholar-mcp.svg)](https://protogrid.dev/servers/io.github.pvliesdonk/scholar-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Dependencies

- pypi pvliesdonk-scholar-mcp@2.0.0: resolved, 97 dependencies, MCP SDK mcp 2.2.0

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

_none_

## Packages

- pypi pvliesdonk-scholar-mcp@2.0.0 secrets: SCHOLAR_GITHUB_TOKEN, SCHOLAR_MCP_S2_API_KEY, SCHOLAR_MCP_VLM_API_KEY, SCHOLAR_MCP_EPO_CONSUMER_SECRET, SCHOLAR_MCP_GOOGLE_BOOKS_API_KEY
- oci ghcr.io/pvliesdonk/scholar-mcp:v2.0.0 secrets: SCHOLAR_MCP_BEARER_TOKEN, SCHOLAR_MCP_OIDC_CLIENT_SECRET, SCHOLAR_MCP_OIDC_JWT_SIGNING_KEY, SCHOLAR_GITHUB_TOKEN, SCHOLAR_MCP_S2_API_KEY, SCHOLAR_MCP_VLM_API_KEY, SCHOLAR_MCP_EPO_CONSUMER_SECRET, SCHOLAR_MCP_GOOGLE_BOOKS_API_KEY

## Tools (0)

_none observed_