zra-mcp@0.4.9
VERIFIED· not startedPublisher claims: "AI-powered Zotero research assistant — a standalone MCP server with 36 tools for literature search, bilingual retrieval, reading analysis, citation management, and review writing." Observed in sandbox: no network, touches nothing outside the project, writes no memory.
Coverage
Not started: dependency install failed; the server itself was not observed.- Tested
- the dependency install step · every file read, file written and host contacted by what ran
- Not tested
- server startup · the tool list · tool behavior
What this means for the label: Verified here covers what ran. The server's tools were not exercised with a real credential, so nothing about their behavior is asserted; the credential summary below says what to do with that.
Before you give it your token
- It will ask for
CORE_API_KEYEVA_JUDGE_API_KEYTWINE_PASSWORDZOTERO_API_KEYConfiguration, not credentials: CHROMA_PERSIST_DIR, CNKI_ENABLED, EMBEDDING_BACKEND, EMBEDDING_BATCH_SIZE, EMBEDDING_DEVICE, EMBEDDING_MAX_SEQ_LEN, EMBEDDING_MODEL, EVA_JUDGE_API_BASE, EVA_JUDGE_MAX_RETRIES, EVA_JUDGE_MODEL, EVA_JUDGE_TEMPERATURE, EVA_JUDGE_TIMEOUT_MS, HF_ENDPOINT, HF_HUB_OFFLINE, OPENALEX_MAILTO, RERANKER_MODEL, UNPAYWALL_EMAIL, ZOTERO_LIBRARY_ID, ZOTERO_LIBRARY_TYPE, ZOTERO_LOCAL, ZRA_ANNOTATION_SCAN_CAP, ZRA_AUTO_SYNC, ZRA_CHROMA_HOST, ZRA_CHROMA_MODE, ZRA_CHROMA_PORT, ZRA_CLEAN_ENABLED, ZRA_HNSW_CONSTRUCTION_EF, ZRA_HNSW_M, ZRA_HNSW_SEARCH_EF, ZRA_INDEX_BILINGUAL_ENRICHMENT, ZRA_NMT_CACHE_DIR, ZRA_RETRIEVAL_LOG, ZRA_SKILLS_DIR, ZRA_SYNC_WORKERS, ZRA_ZOTERO_TIMEOUT- Where it talks to
- no vendor host named in the codeAlso zotero.org, openalex.org, doi.org, arxiv.org, hf-mirror.com, crossref.org, semanticscholar.org, openlibrary.org, unpaywall.org, nih.gov, core.ac.uk — not the publisher's domain; check what for before connecting.
- What we saw when it ran
- no credential files read · no network
- What we could not test
- server startup · the tool list · tool behavior
Connect it with a scoped credential, under the guard, and read the third-party hosts first. The code names zotero.org, openalex.org, doi.org, arxiv.org, hf-mirror.com, crossref.org, semanticscholar.org, openlibrary.org, unpaywall.org, nih.gov, core.ac.uk as well as its own vendor. The guard injects CORE_API_KEY, EVA_JUDGE_API_KEY, TWINE_PASSWORD, ZOTERO_API_KEY only into requests to the host you bind (and its subdomains) and refuses the rest.
Never paste a credential into a chat, a ticket or a report, including ours. How the guard holds it.
Is [email protected] safe to install?
KillerSkills ran it in the KillerSkills honeypot sandbox (2 scenarios; not started: dependency install failed; the server itself was not observed) on 2026-11-22 and scored it 83/100 (Verified). In what ran, nothing we could detect went wrong: no undeclared network egress, no credential reads, no persistent instruction writes. What it does with a real credential was not observed; the static findings and the publisher carry the rest of the score. Summary: no network, touches nothing outside the project, writes no memory.
Behavior trace
Honeypot run · 0 s · 2 scenarios · 0 deviationsStatic findings
- Defaults are zero-config: users should get basic functionality without any `.env` editsFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.- `.env` is gitignored; `.env.example` is committed (template only, no real secrets)Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."Review .env file. Most issues resolve "Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# Load .env before any project importsFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.load_dotenv(Path(__file__).resolve().parent.parent / ".env")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.- New env vars must be documented in: `.env.example`, both READMEs' config tablesFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.- Evaluate whether to update this file + `CHANGELOG.md` on every commit (see `CLAUDE.md` rules)Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.load_dotenv(Path(__file__).resolve().parent.parent / ".env")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."ZOTERO_API_KEY and ZOTERO_LIBRARY_ID to your .env file."Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."HF_ENDPOINT=https://hf-mirror.com in your .env file and retry."Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."and ZOTERO_LIBRARY_ID to your .env file (get them at "Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."ZOTERO_LIBRARY_ID in .env. Get your key at "Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."log in to CNKI, set CNKI_ENABLED=true in .env, restart MCP).\n\n"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.print(f'Files written to scripts/output_old.json, output_new.json, output_context_block.md')Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why."Check CHROMA_PERSIST_DIR in .env and ensure the directory is writable."Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."fix": "Check .env configuration (ZOTERO_LOCAL=true).",Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."国内用户 / China users: set HF_ENDPOINT=https://hf-mirror.com in .env."Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."建议 / Suggestion: 检查 .env 中的 ZOTERO_API_KEY。\n"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.python scripts/generate_eval_queries.py --output my.json # Custom output pathFix: Put hosts, commands and strings in plain source. Decoding at runtime looks identical to malware and costs points on its own.load_dotenv(_project_root / ".env")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."建议 / Suggestion: 在 .env 中配置 ZOTERO_API_KEY 和 ZOTERO_LIBRARY_ID 以启用写入。"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.- Create ~/.pypirc (chmod 600) with your PyPI API token (see header of this script).Fix: Request the narrowest permission that works; replace wildcards with the exact paths or hosts.# Load .env from project root so the script works standalone (not just via MCP)Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."and ZOTERO_LIBRARY_ID in .env. Reads will stay local (fast), writes "Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.load_dotenv(_project_root / ".env")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# 2. ~/.pypirc (recommended — keep it chmod 600)Fix: Request the narrowest permission that works; replace wildcards with the exact paths or hosts."Please ensure Zotero is running and .env is correctly configured."Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."fix": "Check CHROMA_PERSIST_DIR in .env and ensure the directory is writable.",Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.5. `.env.example` — new env vars with commentsFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.load_dotenv(".env")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.Cost to the agent
Tokens estimated at four characters each. The tool list is re-read by the agent on every turn, so it is the number to compare between servers that do the same job: ranked across the index.
Known vulnerabilities
No advisories in OSV for zra-mcp@0.4.9 as of 47 min ago. This is the package itself, not its dependencies.