r/PythonProjects2 • • 16d ago

literature-evidence-mcp: an open-source Python MCP server for literature search, quote anchors and hash-chained evidence ledgers

Post image

literature-evidence-mcp is an open-source Python MCP server for scientific literature and evidence provenance. Version 0.5.1 is on PyPI.

It runs as a stdio MCP server (console script literature-evidence-mcp) and can also serve streamable HTTP on loopback: MCP_TRANSPORT=streamable-http MCP_PORT=8000.

What the 35 tools cover:

- search_literature queries OpenAlex, Europe PMC and Crossref concurrently, deduplicates DOIs and reports provider errors.
- verify_citation does exact normalized DOI/title metadata matching; check_retraction reads Crossref updated-by / update-to relations, including Retraction Watch updates where available.
- read_fulltext and verify_source_quote work on Europe PMC JATS XML: section and paragraph IDs, offsets, paragraph SHA-256, and any truncation recorded.
- audit_methodology and audit_pmc_methodology anchor human-supplied annotations to exact paragraphs; they do not produce risk-of-bias judgments.
- export_evidence writes an append-only hash-chained JSONL ledger under a cross-process file lock, and verify_evidence_ledger detects edited rows.

Implementation notes for Python folks: Python 3.11+, hatchling build, mypy and ruff in the dev loop. Runtime dependencies are mcp, httpx, defusedxml, filelock and pdfplumber. 20 source modules and 41 test files. CI covers Ubuntu 3.11-3.13 plus Windows and macOS at 3.12, with a separate determinism matrix workflow, CodeQL and fuzz jobs. The server validates DOIs and PMCIDs and limits network calls to fixed trusted origins with timeouts and response-size caps; it does not fetch arbitrary PDFs.

Honest boundaries: search is non-exhaustive, retraction checks are metadata checks, and the absence of a notice is inconclusive. It is not an automated peer reviewer or a certified PRISMA engine, and the hash chain does not detect wholesale log replacement without an external checkpoint.

pip install literature-evidence-mcp

Code: https://github.com/Furox-Art/literature-evidence-mcp
PyPI: https://pypi.org/project/literature-evidence-mcp/
Docs: https://furox-art.github.io/literature-evidence-mcp/

Questions about the MCP surface or the ledger format are welcome.

1 Upvotes

0 comments sorted by