article-research-mcp

MCP server for article/tutorial research during agent planning — dev.to search, deduped ranked briefs, methodology aligned with Hermes deep-research.

Agent docs: CONTEXT.md, HERMES.md, docs/adr/, research/

Sources (v0.2)

Source	Id
dev.to	devto
Hacker News (Algolia)	hn
RSS/Atom (configurable)	rss

Default: devto + hn. Add rss via sources=["devto","hn","rss"].

RSS feeds — ARTICLE_RESEARCH_RSS_FEEDS (comma-separated URLs) or built-in defaults (dev.to mcp/ai tags, hnrss frontpage).

LLM scoring (optional)

Set OpenAI-compatible API (e.g. LAN Ollama):

export OPENAI_COMPAT_BASE_URL=http://localhost:11434/v1
export OPENAI_COMPAT_API_KEY=ollama
export OPENAI_COMPAT_MODEL=lfm2.5:latest

• search_articles(..., score_with_llm=true)
• build_topic_brief(..., depth=deep) auto-enables LLM scoring when env is set

Without env vars, deterministic ranking only.

Tools

Tool	Purpose
plan_article_research	Step list + tool sequence for quick/standard/deep
get_research_methodology	Depth levels, source tiers, checklist
search_articles	Multi-source search (devto + hn)
build_topic_brief	Dedupe + rank + markdown brief
get_article	Full body by source + id
save_research_note	Write ~/research/<slug>/ARTICLE_BRIEF.md
list_article_sources	Supported sources + LLM config status

Resources

• article-research://methodology
• article-research://plan/{topic}

Daily briefs (cron)

ARTICLE_DAILY_TOPICS="mcp,agent planning" uv run python scripts/daily_brief.py

Writes ~/research/daily-briefs/<date>-<topic>/BRIEF.md. Hermes cron: research/daily_article_brief.sh at 08:00 UTC (job 6ab3a0a34eb2), delivers summary to this Slack DM when stdout is non-empty.

Run locally

cd /path/to/article-research-mcp
uv sync
uv run article-research-mcp

Dynamic MCP Proxy (catalogue.json)

Entry name: article_research (see DynamicMCPProxy catalogue.json).

Hermes (optional direct register)

cd /path/to/article-research-mcp
uv sync
printf 'y\n' | hermes mcp add article_research \
  --command uv \
  --args --directory,/path/to/article-research-mcp,run,article-research-mcp

New session or /reload-mcp + /reset.

Env

Variable	Default
ARTICLE_RESEARCH_ROOT	~/research
OPENAI_COMPAT_BASE_URL	— (e.g. http://localhost:11434/v1)
OPENAI_COMPAT_API_KEY	ollama
OPENAI_COMPAT_MODEL	lfm2.5:latest

Related

• devto-mcp-server — thin dev.to-only server (superseded for planning use this umbrella)
• Hermes skill deep-research — multi-lens synthesis after briefs

License

MIT