article-research-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@article-research-mcp research best practices for MCP server development"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
|
Hacker News (Algolia) |
|
RSS/Atom (configurable) |
|
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).
Related MCP server: News Aggregator MCP Server
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:latestsearch_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 |
| Step list + tool sequence for quick/standard/deep |
| Depth levels, source tiers, checklist |
| Multi-source search (devto + hn) |
| Dedupe + rank + markdown brief |
| Full body by |
| Write |
| Supported sources + LLM config status |
Resources
article-research://methodologyarticle-research://plan/{topic}
Daily briefs (cron)
ARTICLE_DAILY_TOPICS="mcp,agent planning" uv run python scripts/daily_brief.pyWrites ~/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-mcpDynamic 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-mcpNew session or /reload-mcp + /reset.
Env
Variable | Default |
|
|
| — (e.g. |
|
|
|
|
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
Available Tools
7 toolsbuild_topic_briefC
Fetch, dedupe, rank articles and return a markdown brief for planning. depth=deep enables LLM scoring automatically when OPENAI_COMPAT_* is set.
Inputs: topic (required), depth, limit, tag, +2 more. Returns: result
get_articleB
Fetch full article body by source and numeric id (devto | hn).
Inputs: source (required), article_id (required). Returns: result
get_research_methodologyA
Full methodology markdown (depth levels, source tiers, checklist).
Inputs: no named parameters. Returns: result
list_article_sourcesA
List supported sources and whether LLM scoring is configured.
Inputs: no named parameters. Returns: result
plan_article_researchC
Return a structured research plan for agents (steps, tool order, output paths). depth: quick | standard | deep
Inputs: topic (required), depth, tags. Returns: result
save_research_noteC
Persist a research note under ~/research// (creates dirs).
Inputs: topic (required), content_markdown (required), slug, filename. Returns: result
search_articlesA
Search article sources (default: devto + hn). Returns unified summaries. Set score_with_llm=true when OPENAI_COMPAT_BASE_URL is configured (e.g. Ollama).
Inputs: query (required), sources, limit, tag, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool serves a distinct function: planning, searching, briefing, fetching articles, saving notes, and providing metadata. No two tools have overlapping purposes, ensuring clear selection.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., build_topic_brief, get_article, list_article_sources). No mixing of styles or conventions.
Seven tools cover the core research workflow without being excessive. The scope is well-balanced, providing essential functionality without bloat.
The set covers planning, searching, fetching, and saving, but lacks a tool to retrieve or list saved research notes. This minor gap does not critically impair the workflow.
Maintenance
Related MCP Connectors
Web search and page reading for AI agents, including JSON APIs, RSS feeds and YouTube.
Your curated sources (RSS, YouTube, podcasts, Google News) as context for any AI agent.
Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.
Fetch any RSS/Atom feed as clean JSON or extract article text from any URL. Built for AI agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to run research queries across multiple public sources (Hacker News, Reddit, GitHub, Brave Search) in parallel, returning normalized results.5MIT
- AlicenseAqualityDmaintenanceEnables AI agents to fetch and search news from multiple sources including RSS/Atom feeds, HackerNews, and GDELT global news intelligence without requiring an API key.1128 PyPI4MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to fetch categorized news headlines and full article text from a multi-topic RSS aggregator, with no API keys required.-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to browse and read curated software-development feeds, fetch any RSS/Atom/RDF feed via URL, and filter items by keywords.89 npmMIT