📚 Paper Distill MCP Server
Academic paper search, intelligent curation, and multi-platform delivery — built on the .
Alimenter votre agent
La commande propre à l'éditeur. Ce n'est pas un endpoint PlugMCP.
Host a copy with our keys and logs.
uvx paper-distill-mcp==0.2.4Claude Code n'a pas de lien d'installation pour une commande locale. Copiez la commande ci-dessous et exécutez-la dans un terminal.
OPENALEX_EMAIL=<value> CORE_API_KEY=<secret> TELEGRAM_BOT_TOKEN=<secret> TELEGRAM_CHAT_ID=<value> DISCORD_WEBHOOK_URL=<secret> ZOTERO_LIBRARY_ID=<value> ZOTERO_API_KEY=<secret> claude mcp add io.github.eclipse-cj-paper-distill-mcp -- uvx paper-distill-mcp==0.2.4À exécuter dans un terminal.
{ "mcpServers": { "io.github.eclipse-cj-paper-distill-mcp": { "command": "uvx", "args": [ "paper-distill-mcp==0.2.4" ], "env": { "OPENALEX_EMAIL": "<value>", "CORE_API_KEY": "<secret>", "TELEGRAM_BOT_TOKEN": "<secret>", "TELEGRAM_CHAT_ID": "<value>", "DISCORD_WEBHOOK_URL": "<secret>", "ZOTERO_LIBRARY_ID": "<value>", "ZOTERO_API_KEY": "<secret>" } } }}claude_desktop_config.json
URL distante ou commande sur votre machine ? Ce qui distingue les deux installations
Exécuter sur PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LancerCompatible with all MCP clients: Claude Desktop, Claude Code, Cursor, Trae, Codex CLI, Gemini CLI, OpenClaw, VS Code, Zed, and more.
⚠️ Early development stage. Many features are still being validated and may contain bugs or instabilities. Feedback and bug reports are warmly welcome!
uvx paper-distill-mcp
That's it. Your AI client will discover all tools automatically. No API keys required for basic paper search.
No
uv? →curl -LsSf https://astral.sh/uv/install.sh | shorbrew install uv
pip:
pip install paper-distill-mcp
Homebrew:
brew tap Eclipse-Cj/tap
brew install paper-distill-mcp
Docker:
docker run -i --rm ghcr.io/eclipse-cj/paper-distill-mcp
From source (developers):
git clone https://github.com/Eclipse-Cj/paper-distill-mcp.git
cd paper-distill-mcp
python3 -m venv .venv && .venv/bin/pip install --upgrade pip && .venv/bin/pip install -e .
Add to claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"paper-distill": {
"command": "uvx",
"args": ["paper-distill-mcp"]
}
}
}
claude mcp add paper-distill -- uvx paper-distill-mcp
Or add to .mcp.json:
{
"mcpServers": {
"paper-distill": {
"command": "uvx",
"args": ["paper-distill-mcp"]
}
}
}
Add to ~/.codex/config.toml:
[mcp_servers.paper-distill]
command = "uvx"
args = ["paper-distill-mcp"]
Add to ~/.gemini/settings.json:
{
"mcpServers": {
"paper-distill": {
"command": "uvx",
"args": ["paper-distill-mcp"]
}
}
}
mcporter config add paper-distill --command uvx --scope home -- paper-distill-mcp
mcporter list # verify
To remove:
mcporter config remove paper-distill
git clone https://github.com/Eclipse-Cj/paper-distill-mcp.git ~/.openclaw/tools/paper-distill-mcp
cd ~/.openclaw/tools/paper-distill-mcp
uv venv .venv && uv pip install .
mcporter config add paper-distill \
--command ~/.openclaw/tools/paper-distill-mcp/.venv/bin/python3 \
--scope home \
-- -m mcp_server.server
mcporter list
To remove:
rm -rf ~/.openclaw/tools/paper-distill-mcp && mcporter config remove paper-distill
Same JSON config, different config file paths:
paper-distill-mcp --transport http --port 8765
After connecting your client, tell the agent "initialize paper-distill". It will call setup() and walk you through:
pool_refresh() populates the paper poolAll settings can be updated at any time through conversation:
All parameters are set via configure() or add_topic() — no manual file editing needed.
add_topic / manage_topics)configure)💡 Dual blind review: two independent AI reviewers each shortlist papers; a chief reviewer makes the final push/overflow/discard call. Papers that don't make the cut are held for the next cycle rather than discarded. Enable with
configure(review_mode="dual").
configure)Controls paper scoring. The four weights should sum to approximately 1.0.
Example: "Prioritize recent papers" →
configure(w_recency=0.35, w_relevance=0.40)
configure)Abstract extraction is the most token-intensive step. It runs on the main agent by default, but can be delegated to a cheaper model to cut costs significantly.
🔧 Strongly recommended: for 30+ papers, frontier model costs add up fast. A $0.14/M-token model handles extraction just as well. Set this with
configure(summarizer="scraper").
configure)pool_refresh() searches all 11 APIs and fills the pool. The pool is then split into batches for daily AI review — avoiding a single 60+ paper dump.
scan_batches=2 (default): review first half on day 1, second half on day 2, finalize on day 3scan_batches=3: review one-third per day, finalize on day 4When all batches are reviewed, the pool is exhausted and the next run triggers a fresh API search automatically.
⚠️ Important: set environment variables in the MCP client config
envfield, not as system environment variables. Otherwisesend_push()cannot access the webhook URL and the AI may generate scripts that call webhooks directly, causing encoding issues.
Config example (WeCom + Claude Desktop):
{
"mcpServers": {
"paper-distill": {
"command": "uvx",
"args": ["paper-distill-mcp"],
"env": {
"WECOM_WEBHOOK_URL": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY"
}
}
}
}
Restart the MCP client after editing the config.
Push message format (fixed):
1. Paper Title (Year)
Journal Name
- One-sentence summary
- Why it was selected
https://doi.org/...
configure)Personal paper library website, auto-updated on every push. Built on Astro + Vercel (free tier).
Setup steps (the AI agent will guide you):
configure(site_deploy_hook=...)After setup, every finalize_review() call pushes the digest JSON to the site repo and triggers a Vercel rebuild. The site updates in ~30 seconds.
Save papers to Zotero with one command. Requires a Zotero account and API key.
Getting credentials:
Add to MCP client config:
{
"mcpServers": {
"paper-distill": {
"command": "uvx",
"args": ["paper-distill-mcp"],
"env": {
"ZOTERO_LIBRARY_ID": "your userID",
"ZOTERO_API_KEY": "your API key"
}
}
}
}
After setup, reply collect 1 3 after a push to save papers 1 and 3 to Zotero, automatically sorted into per-topic folders.
AI client (Claude Code / Codex CLI / Gemini CLI / Cursor / ...)
↓ MCP (stdio or HTTP)
paper-distill-mcp
├── search/ — 11-source academic search (with OA full-text enrichment)
├── curate/ — scoring + deduplication
├── generate/ — output (JSONL, Obsidian, site)
├── bot/ — push formatting (4 platforms)
└── integrations/ — Zotero API
The server does not call any LLM internally. Search, ranking, and deduplication are pure data operations. Intelligence comes from your AI client.
The system searches all papers by default (including subscription journals) and maximizes free full-text access through:
For papers with no free version, the system returns a DOI link. If you have institutional VPN access, clicking the DOI link while connected is usually enough — publishers identify your institution by IP.
open_access_urlpriority: arXiv > CORE > Unpaywall > OpenAlex > Semantic Scholar > Papers with Code
Symptom: the review prompt generated by prepare_review() causes the AI client to hang or time out.
Cause: too many candidate papers in the pool (e.g. 80–100), making the prompt exceed the client's context window or output token limit. VS Code Copilot and some IDE plugins have limited context capacity.
Solutions (pick one):
scan_batches (recommended) — split the pool into more batches:
configure(scan_batches=5)
Requires-Python >=3.10Python 3.10+ is required. macOS ships with Python 3.9 by default — install a newer version with brew install [email protected] or use uv.
ghcr.io is blocked in mainland China. Use pip with a Chinese mirror:
pip install paper-distill-mcp -i https://pypi.tuna.tsinghua.edu.cn/simple
git clone https://github.com/Eclipse-Cj/paper-distill-mcp.git
cd paper-distill-mcp
python3 -m venv .venv && .venv/bin/pip install --upgrade pip && .venv/bin/pip install -e .
python tests/test_mcp_smoke.py # 9 tests, no network required
This project is licensed under AGPL-3.0. See LICENSE for details.
Unauthorized commercial use is prohibited. For commercial licensing inquiries, contact the author.
Bug reports and feature requests are welcome. The project is in active early development — thank you for your patience and support 🙏
Academic paper search across 11 sources with AI curation, ranked push, Zotero and Obsidian support.
{ "mcpServers": { "io.github.eclipse-cj-paper-distill-mcp": { "command": "uvx", "args": [ "paper-distill-mcp==0.2.4" ], "env": { "OPENALEX_EMAIL": "<value>", "CORE_API_KEY": "<secret>", "TELEGRAM_BOT_TOKEN": "<secret>", "TELEGRAM_CHAT_ID": "<value>", "DISCORD_WEBHOOK_URL": "<secret>", "ZOTERO_LIBRARY_ID": "<value>", "ZOTERO_API_KEY": "<secret>" } } }}Outils
Pas encore de liste d'outils. Les serveurs distants en obtiennent une après le premier contrôle d'état.
FAQ
Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.
L'éditeur indique ces variables d'environnement : OPENALEX_EMAIL, CORE_API_KEY, TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID, DISCORD_WEBHOOK_URL, ZOTERO_LIBRARY_ID, ZOTERO_API_KEY.
Paper Distill MCP s'exécute en local via stdio.
Dernière vérification : 2026-11-09. Academic paper search across 11 sources with AI curation, ranked push, Zotero and Obsidian support.