asta-skill MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Eight Semantic Scholar tools via MCP (get_paper, search_papers_by_relevance, get_citations, snippet_search, ...)
Intent→tool decision table so Claude picks the right function
Workflow patterns to avoid context-blow-up pitfalls (fields=citations warning baked in)
Batch operations for efficiency (get_paper_batch)
Works across Claude Code / Codex / Cursor / Windsurf / OpenClaw

Demo ao vivo

Como fica na prática

asta-skill.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "asta-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/asta-skill",
        "~/.claude/skills/asta-skill"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "asta-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/asta-skill",
        "~/.claude/skills/asta-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "asta-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/asta-skill",
        "~/.claude/skills/asta-skill"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "asta-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/asta-skill",
        "~/.claude/skills/asta-skill"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "asta-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/asta-skill",
        "~/.claude/skills/asta-skill"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "asta-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Agents365-ai/asta-skill",
          "~/.claude/skills/asta-skill"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add asta-skill -- git clone https://github.com/Agents365-ai/asta-skill ~/.claude/skills/asta-skill

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: asta-skill

Run a literature review on a specific research question

👤 Grad students and researchers ⏱ ~60 min intermediate

Quando usar: You have a question and want to quickly map the relevant papers, not wade through Google Scholar.

Pré-requisitos

Skill cloned — git clone https://github.com/Agents365-ai/asta-skill ~/.claude/skills/asta-skill
Ai2 Asta MCP server reachable — Follow Asta MCP setup; the skill assumes the MCP is configured

Fluxo

Kick off the search

Use asta-skill — find highly-cited papers on retrieval-augmented generation from 2023-2024.✓ Copiado

→ Claude calls search_papers_by_relevance with good filters, not a generic query
Walk the citation graph

For the top 3, show me what cited them since.✓ Copiado

→ get_citations calls with appropriate filtering
Pull evidence snippets

Extract a 500-word passage from each paper explaining their main evaluation method.✓ Copiado

→ snippet_search returns targeted passages

Resultado: A mapped review with citation chains and evidence snippets — not just titles.

Armadilhas

Requesting fields=citations bulk-returns megabytes — The skill warns against this — trust the guidance and paginate instead

Combine com: planning-with-files

Find a researcher's key papers and trace their influence

👤 Anyone profiling a potential collaborator or advisor ⏱ ~20 min beginner

Quando usar: You want a fast, accurate view of someone's publication record.

Fluxo

Resolve the author

asta-skill — find the author 'Jane Smith' who works on graph neural networks.✓ Copiado

→ search_authors_by_name with disambiguation
Fetch papers

Get their papers sorted by citation count.✓ Copiado

→ get_author_papers call with sort
Impact snapshot

For the top 3, who's cited them most and is building on the work?✓ Copiado

→ Citation traversal showing ongoing lineage

Resultado: A one-page profile of a researcher's impact.

Combinações

Combine com outros MCPs para 10× de alavancagem

asta-skill + planning-with-files

Literature reviews span days — persist findings.md and next-reads.md

Use planning-with-files — findings.md for papers read, next-reads.md for the queue.✓ Copiado

asta-skill + filesystem

Save extracted snippets as notes in your Obsidian vault

For each paper, save the snippet to ~/obsidian/papers/<title>.md.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
search_papers_by_relevance	query + filters	Starting a literature search from a question	1 MCP call
get_paper / get_paper_batch	id or [ids]	Need full metadata on a known paper or list	1 MCP call (batch saves round-trips)
get_citations	paper id + filters + pagination	Walking citation graph forward	1 MCP call
snippet_search	paper id + query	Need evidence-level passages to ground claims	1 MCP call
search_authors_by_name / get_author_papers	name + disambiguators	Profiling a researcher	1 MCP call

Custo e limites

O que custa rodar

Cota de API: Semantic Scholar API limits via Asta MCP — check Ai2's current terms
Tokens por chamada: Varies; fields=citations can blow up context so avoid it
Monetário: Free — skills are local files; Asta MCP itself is free for research use
Dica: Prefer batch calls and paginated citation fetches; snippet_search beats fetching full bodies.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: No credentials in the skill. Asta MCP setup may involve API keys.

Saída de dados: Queries go to Semantic Scholar via the Asta MCP server

Solução de problemas

Erros comuns e correções

Skill not invoked — Claude does a web search instead of calling Asta

Say 'use asta-skill' explicitly; academic tasks alone don't always route to MCP.

Verificar: ls ~/.claude/skills/asta-skill/SKILL.md

SKILL.md frontmatter wrong

Re-clone; the description is what triggers auto-activation.

Verificar: head ~/.claude/skills/asta-skill/SKILL.md

Wrong trigger keywords — context blows up on citation fetch

Don't request fields=citations — paginate with get_citations and filters.

Alternativas

asta-skill vs. outros

Alternativa	Quando usar	Troca
arxiv MCP	You only need preprints, not cross-source citation graphs	Narrower source; no citation traversal
Raw Google Scholar	Quick one-off lookups without MCP setup	No structured tools, scraping-ish

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills