Skip to main content
Glama
article-research-mcp

article-research-mcp

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).

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: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

  • 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 tools
build_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

    A3.5/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    Seven tools cover the core research workflow without being excessive. The scope is well-balanced, providing essential functionality without bloat.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to run research queries across multiple public sources (Hacker News, Reddit, GitHub, Brave Search) in parallel, returning normalized results.
      5
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to fetch categorized news headlines and full article text from a multi-topic RSS aggregator, with no API keys required.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to browse and read curated software-development feeds, fetch any RSS/Atom/RDF feed via URL, and filter items by keywords.
      89 npm
      MIT