mcpField
A
academic-research

academic-research

github.com/tdiminoProductivity41205 installsUpdated 1w ago
Repository

About academic-research

academic-research is a skill guide for academic paper discovery, literature reviews, and research synthesis, combining Exa search scripts with arxiv-mcp-server workflows. It also documents source-extraction escalation, date and domain filters, and methods for paper analysis and citation research.

Key features

  1. 01Search papers with academic filters
  2. 02Narrow results by date or domain
  3. 03Search, download, and read arXiv papers
  4. 04Synthesize findings across papers
  5. 05Track citations and recent research
  6. 06Escalate source extraction methods

Use cases

  1. 01Discover papers on a research topic
  2. 02Review literature and compare methods
  3. 03Track recent work in a field
  4. 04Retrieve and analyze full arXiv papers

MCP support

The skill describes using arxiv-mcp-server tools including search_papers, download_paper, list_papers, and read_paper, and notes a hosted Exa MCP server as an academic search option.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tdimino/claude-code-minoan --skill academic-research

After installing, type/academic-researchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
references/
arxiv-mcp-tools.md
exa-academic-search.md
obscura-academic-patterns.md
scripts/
academic_stealth_fetch.sh

Details

From the project README

Academic Research

This skill provides comprehensive guidance for academic paper search, literature reviews, and research synthesis using the exa-search scripts and arxiv-mcp-server.

When to Use This Skill

  • Searching for academic papers on a topic
  • Conducting literature reviews
  • Finding papers by specific authors
  • Discovering recent research in a field
  • Downloading and analyzing arXiv papers
  • Synthesizing findings across multiple papers
  • Tracking citation networks and influential papers
  • Researching state-of-the-art methods in AI/ML

Available Tools

Exa Search (Web Search with Academic Filtering)

Scripts: ~/.claude/skills/exa-search/scripts/ (exa_search.py, exa_contents.py, exa_research.py, exa_agent.py)

Key Flags for Academic Search:

  • --category publication - Filter results to papers, preprints, and proceedings
  • --domains arxiv.org - Restrict to arXiv (repeat for more venues; cannot combine with --category publication)
  • --after / --before - Filter by publication date

The hosted Exa MCP server is an alternative; its filters live only in the opt-in web_search_advanced_exa tool (see references/exa-academic-search.md).

ArXiv MCP Server (Paper Search, Download, Analysis)

Tools: search_papers, download_paper, list_papers, read_paper

Capabilities:

  • Search arXiv by keyword, author, or category
  • Download papers locally (~/.arxiv-papers)
  • Read paper content directly
  • Deep paper analysis with built-in prompts

Core Workflows

Workflow 1: Quick Paper Discovery

Use case: Find papers on a specific topic quickly

Step 1: Use Exa with the publication category
python3 ~/.claude/skills/exa-search/scripts/exa_search.py \
  "a survey of transformer attention mechanisms" \
  --category publication --highlights --no-text -n 10

Step 2: Review titles and abstracts
Step 3: Note arXiv IDs for deeper analysis
Workflow 2: ArXiv-Focused Search

Use case: Search specifically within arXiv

Step 1: Use arxiv MCP search_papers
search_papers({
  query: "large language models reasoning",
  max_results: 20,
  sort_by: "relevance"
})

Step 2: Download papers
download_paper({ arxiv_id: "2301.00234" })

Step 3: Read and analyze
read_paper({ arxiv_id: "2301.00234" })
Workflow 3: Comprehensive Literature Review
Step 1: Broad discovery with Exa (--category publication)
Step 2: Identify key papers and authors
Step 3: Deep dive with arXiv MCP (download + read_paper)
Step 4: Synthesize findings by methodology/approach
Workflow 4: Recent Developments Tracking
Step 1: Time-filtered Exa search
python3 ~/.claude/skills/exa-search/scripts/exa_search.py \
  "multimodal large language models" \
  --category publication --after 2026-01-01 --highlights --no-text

Step 2: Sort arXiv by submitted_date
search_papers({ query: "multimodal LLM", sort_by: "submitted_date" })

ArXiv Categories Reference

CategoryDescription
cs.AIArtificial Intelligence
cs.CLComputation and Language (NLP)
cs.CVComputer Vision
cs.LGMachine Learning
cs.NENeural and Evolutionary Computing
stat.MLStatistics - Machine Learning
cs.RORobotics

Academic Domain Filtering

For Exa searches, restrict to academic sources (repeated flags accumulate; omit --category publication, which rejects --domains):

--domains arxiv.org --domains aclanthology.org --domains openreview.net \
--domains proceedings.mlr.press --domains papers.nips.cc --domains openaccess.thecvf.com

Tool Selection Guide

TaskPrimary ToolAlternative
Broad topic searchExa (--category publication)arXiv search_papers
ArXiv-specificarXiv search_papersExa with --domains arxiv.org
Download paperarXiv download_paper-
Full paper contentarXiv read_paper-
Code implementationsExa with --domains github.com-
Very recent papersarXiv (submitted_date)Exa with --after
Multi-hop review, paper listsexa_agent.py run-
Bot-protected sitesObscura --stealthScrapling (Turnstile)
Batch stealth scrapeObscura scrape-
Source Extraction Escalation

When a source isn't on ArXiv or Exa can't reach it, escalate through:

  1. ArXiv MCP → paper is on arXiv (free, full text, best quality)
  2. Exa contents → URL known, site allows crawling
  3. Firecrawl → JS-heavy site, no anti-bot
  4. Obscura --stealth → site fingerprints headless browsers (JSTOR, Scholar, Persée, PubMed, Academia.edu)
  5. Scrapling → site uses Cloudflare Turnstile
Obscura Stealth Extraction (Tier 3)

For gated academic sources that block standard headless browsers via canvas/WebGL fingerprinting. Not for bypassing paywalls — for extracting publicly visible metadata, abstracts, and open-access content.

Verified sites (2026-04-24): Google Scholar, JSTOR, Persée, PubMed, Academia.edu, Perseus Digital Library.

# Quick metadata extraction (auto-detects site type from URL)
bash ~/.claude/skills/academic-research/scripts/academic_stealth_fetch.sh URL

# With explicit site type
bash ~/.claude/skills/academic-research/scripts/academic_stealth_fetch.sh URL scholar

# Direct Obscura usage
obscura fetch --stealth --quiet URL --eval "JS_EXPRESSION"

See references/obscura-academic-patterns.md for site-specific JS extraction patterns and gotchas.

Best Practices

  1. Start broad with Exa's publication category, then narrow
  2. Use date filtering for recent developments
  3. Download key papers via arXiv MCP for persistent access
  4. Cross-reference multiple search approaches
  5. Use technical terms in queries for better results

Domain: Subquadratic Attention

Research domain for post-transformer attention mechanisms that break the O(n^2) barrier. Active area with rapid publication cadence (2024–2026).

Key Papers
PaperYearKey Contribution
FlashAttention-2 (Dao)2023IO-aware exact attention — foundation for all subsequent work
DuoAttention2024Split attention heads into retrieval (sparse) vs streaming (full)
Ring Attention2024Distributed sequence parallelism across devices
MoBA (Mixture of Block Attention)2025Block-sparse top-k gating with Triton kernel, 1M tokens
NSA (Native Sparse Attention, DeepSeek)2025Hardware-aligned sparse attention patterns
TokenSelect2025Dynamic per-layer token pruning
Pre-Built Search Queries
# Exa (publication category)
"subquadratic attention mechanism" --category publication --after 2024-01-01
"block sparse attention triton kernel" --category publication
"mixture of attention heads sparse" --category publication
"linear attention transformer approximation" --category publication --after 2024-06-01

# ArXiv (cs.LG + cs.CL)
search_papers({ query: "subquadratic attention sparse transformer", max_results: 20, sort_by: "submitted_date" })
search_papers({ query: "block sparse FlashAttention kernel", max_results: 10 })
Evaluation Criteria

When comparing subquadratic attention mechanisms, benchmark on:

CriterionWhat to Measure
QualityPerplexity degradation vs full attention at target sequence length
SpeedWall-clock speedup on consumer GPUs (RTX 4090, M4 Max)
MemoryReduction factor at 128K / 512K / 1M context
CompatibilityDrop-in replacement vs requires retraining
SparsityHow much computation is actually skipped (e.g., 95% at 1M tokens)
Local Implementation Reference

Working MoBA implementation with Triton kernels: ~/Desktop/Aldea/01-Repos/perplexity-clone/model/moba_block_sparse.py


Reference Documentation

For detailed parameters and advanced usage:

  • references/exa-academic-search.md - Exa script recipes and MCP tools for academic search
  • references/arxiv-mcp-tools.md - ArXiv MCP server tool reference
  • references/obscura-academic-patterns.md - Site-specific Obscura extraction patterns with JS expressions and gotchas

Comments

Markdown supported