Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Aspero

БесплатноНе проверен

aspero as a Model Context Protocol server: search, look up, verify and identify scholarly works from an agent

GitHubEmbed

Описание

aspero as a Model Context Protocol server: search, look up, verify and identify scholarly works from an agent

README

Find, resolve and verify scholarly references from the command line — built for AI agents first, and humans too.

Agents asked to cite literature tend to recall DOIs from memory (often wrong) or try web search (usually blocked for bots). aspero asks the open scholarly APIs instead — OpenAlex, Crossref, DataCite, doi.org, Europe PMC and Open Library — politely, with caching, and answers in JSON with exit codes an agent can act on.

$ aspero verify "LeCun Y, Bengio Y, Hinton G. Deep learning. Nature. 2015. doi:10.1038/nature14540"
MISMATCH  LeCun Y, Bengio Y, Hinton G. Deep learning. Nature. 2015. doi:10.1038/nature14540
  doi:10.1038/nature14540 is "Reinforcement learning improves behaviour from evaluative feedback" (2015), openalex:W1589747210, but the citation matches "Deep learning" (2015), doi:10.1038/nature14539

Install

Homebrew (macOS, Linux):

brew install transilluminate/tap/aspero

Prebuilt binary, via the install script:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/transilluminate/aspero/releases/latest/download/aspero-installer.sh | sh

From source, with Cargo:

cargo install aspero

Optional environment:

Variable Purpose
OPENALEX_API_KEY Free OpenAlex key ($1/day budget; lookups free, searches $0.001)
ASPERO_MAILTO Your contact address, sent to polite API pools (Crossref)
ASPERO_CACHE_DIR Where to keep the answer cache

More settings (a spending cap, sources to leave out, the cache's trust and size) are under Settings.

Use

# Does this citation refer to a real work, with matching details?
aspero verify "Vaswani 2017 Attention is all you need"
aspero verify --title "Deep learning" --author LeCun --year 2015 --id 10.1038/nature14539
aspero verify - < citations.txt        # one claim per line, text or JSON

# Check a whole bibliography: BibTeX, RIS, CSL-JSON, or a Word document's
# Zotero/Mendeley citations (CI-friendly: exits 9 on errors)
aspero check refs.bib
aspero check paper.docx
aspero check --fail-on warning --format json thesis.ris

# Write what's found as BibTeX, RIS or CSL-JSON, or as a reference list in a style
aspero lookup --format bibtex 10.1038/nature14539 arXiv:1706.03762
aspero verify --format ris - < citations.txt
aspero search --format csl-json "sepsis fluid resuscitation" > zotero.json
aspero verify --style vancouver - < citations.txt   # `aspero styles` lists them

# Look up identifiers: DOIs, arXiv IDs, PMIDs, PMCIDs, NBK IDs, ISBNs,
# Elsevier PIIs, and their URLs, publishers' article pages included
aspero lookup 10.1038/nature14539 arXiv:1706.03762 "ISBN 978-0-262-03561-3"
aspero verify https://www.sciencedirect.com/science/article/pii/S2772940026000032

# An article page whose address doesn't say (JAMA, Oxford Academic): its
# saved markup's citation_*, PRISM, Dublin Core or JSON-LD metadata (offline)
aspero verify --html page.html --url https://jamanetwork.com/journals/jama/fullarticle/2856706
# Or its address and the title a browser gave it: the site's publisher
# (JAMA's 10.1001) decides between works of the same title
aspero verify --url https://jamanetwork.com/journals/jama/article-abstract/2856706 \
  --title "Treatment of Acute Ischemic Stroke: A Review | JAMA | JAMA Network"
# A page that isn't a scholarly work (Wikipedia, news, guidance) is a web
# page: its record, or a web citation of it, read today
aspero verify --html page.html --url https://en.wikipedia.org/wiki/Gene_Hackman --format bibtex

# Which paper is this PDF? From its first page's text and title
pdftotext -l 1 paper.pdf - | aspero identify --title "Deep learning"

# Find the identifiers in documents (offline), then look them up
aspero scan notes/*.md
aspero scan --format jsonl page.md | aspero lookup -   # each result echoes its mention

# Search, resolve, and include abstracts
aspero search "protein folding" --year 2020.. --source europepmc
aspero search --author lecun --title "deep learning" --sort most-cited
aspero search --query '{"all": [{"cites": "10.1038/nature14539"}, {"title": "survey"}, {"not_retracted": true}]}'
aspero search --query '{"all": [{"id": "10.1038/nature14539"}, {"not_retracted": true}]}'   # that work, if not retracted
aspero search sepsis --since 2026-11-01      # only works added since: watch a search
aspero resolve --abstract "Jumper J et al. Highly accurate protein structure prediction with AlphaFold. Nature 2021"

# Citation links: a work's references; and a set of works checked for
# retracted references, odd ones out, works probably missing from it, and
# related works
aspero references 10.1038/nature14539 --limit 50
aspero analyse refs.bib --estimate          # what it would cost, free
aspero analyse refs.bib --budget 0.01       # fractions of a cent for 50 works
aspero analyse refs.bib --kinds related     # works around the set, ~$0.006
aspero analyse 10.1056/nejmoa010307 10.1056/nejmoa1401602 10.1056/nejmoa1500896

# What's used of today's OpenAlex budget (free; needs a key)
aspero budget

# The crates and data aspero is built from, and their licences; --full
# prints the third-party notices
aspero licences

# Watch the requests (and concurrency) as they happen
aspero verify -v "Bishop CM. Pattern Recognition and Machine Learning. 2006"

On a terminal, results are tables (a single verify is a short report); piped, they're JSON. Pick explicitly with --format table|text|json|jsonl: text is a detailed report per result. lookup, search and verify also take --format bibtex|ris|csl-json, and --style apa|vancouver|… or a .csl file for a formatted reference list. Every command's --help has examples and the exit codes.

What verify and check catch: invented papers, real DOIs attached to the wrong work, nonexistent DOIs (with the right one suggested), wrong years, misattributed authors, retracted papers, duplicates, and missing DOIs. Lookalike re-deposits of famous papers are told apart by year and authors. analyse reads the citation links between a set of works (from OpenAlex): which cite retracted work, which are linked to none of the others, which works most of them cite but the set lacks, and (--kinds related) which works around them are read with them or share their references. A work whose references OpenAlex doesn't have (often a book) is reported as such, never as unlinked.

Accuracy

The promise: a fabricated or miscited reference shouldn't come back verified; plausible means "looks like this work, check it". How that's measured (a red-team corpus of real and wrong citations, held-out rounds, acceptance criteria), the results, and what verify can't check are in docs/accuracy.md. A verdict that looks wrong: aspero verify --report "<citation>" prints a link to a wrong-verdict issue, filled in; nothing is sent unless you open it and submit.

Agents (MCP)

Agents that speak the Model Context Protocol can use aspero as tools rather than through the shell. aspero mcp serves them over stdio, for the agent to launch; with Claude Code:

claude mcp add aspero -- aspero mcp

The tools: search (a query tree, the JSON that search --query takes, or keywords), search_supports, lookup, verify (one citation, text or fields, or a batch), identify (a first page's text), and citing_works and references (the works citing a work, and its references). Results are the JSON the commands print, as structured content with a short text summary; full: true gives every field.

Each session may spend up to --budget dollars (default $0.25) on OpenAlex searches; once it has, tools that may spend are refused. Every result reports its usage and the session's spend. The environment, cache and pacing are the other commands'.

Agents (MCP) in an app

An app that embeds aspero (the FFI's McpServer, in the xcframework) can serve the same tools, and its own, over Streamable HTTP on http://127.0.0.1:<port>/mcp (default port 23130), to agents holding a bearer key the app minted:

claude mcp add --transport http aspero http://127.0.0.1:23130/mcp \
  --header "Authorization: Bearer <token>"

Only loopback, only with a key (aspero keeps its SHA-256, never the token), and never from a browser. Each key has scopes (sources for aspero's own tools; for the app's, the scopes the app declares, such as reading or adding to its history) and a daily budget; each session its own budget. The app hears of every tool call as it happens.

How it behaves

  • Cheap: free sources first; paid OpenAlex searches only when needed, with spend reported. A day's free budget covers hundreds of verifications.
  • Polite: per-provider pacing, backoff on rate limits, contact address in the user agent; lookups fall back provider by provider rather than asking all at once.
  • Cached: answers are kept (records 7 days, searches and "not found" 1 day, references 30 days), so re-checking a bibliography is near-instant and free. aspero cache stats|clear|path. Before submitting, --fresh checks again past the cache (any retraction or correction since, a work registered since it was "not found") and caches the new answers; where a source fails, the cached answer is served, marked stale. --no-cache neither reads nor writes the cache.

Settings

Each is a global flag, or its environment variable (the app sets them in its Config):

Flag (variable) Effect
--openalex-cap-usd USD (ASPERO_OPENALEX_CAP_USD) Stop OpenAlex's paid calls once today's use, as OpenAlex reports it for the key, reaches this; lookups (free) go on, checks fall back to the free sources, searches that need OpenAlex fail (exit 5). aspero budget shows today's use.
--openalex-credit-cap-usd USD (ASPERO_OPENALEX_CREDIT_CAP_USD) Once the free allowance is all used today (by anything using the key), spend prepaid credit only while the credit aspero spent today, through this cache file, is under this; default 0.25, 0 never spends credit. See below.
--without europepmc,openlibrary (ASPERO_DISABLED_SOURCES) Sources never to ask: openalex, crossref, datacite, doi, europepmc, openlibrary.
--cache-found-days N (ASPERO_CACHE_FOUND_DAYS) How long a found record is trusted (default 7).
--cache-not-found-days N (ASPERO_CACHE_NOT_FOUND_DAYS) How long a "not found" is trusted (default 1).
--cache-max-mb N (ASPERO_CACHE_MAX_MB) Limit the cache's size; the least recently used answers go first. aspero cache stats shows the size.

OpenAlex's paid calls, with "used" counting everything using the key and "spent here" only aspero's own calls through this cache file (OpenAlex gives one key per account, shared with your scripts and other tools): (a) free allowance used today under the allowance cap: go; (b) past the allowance cap with some allowance left: stop, holding the rest back for other tools; (c) the allowance all gone and credit spent here today under the credit cap ($0.25 unless set): go, on credit; (d) credit spent here today at the credit cap: stop until midnight UTC. A last call, or calls in flight together, can pass a cap by their own cost, and others' spending shows only in the next response. aspero budget shows both.

Library

The CLI is a thin adapter over aspero-engine, with its JSON shapes in aspero-json; providers are separate crates behind features, and the MCP server is aspero-mcp. Apps use aspero-ffi: Swift bindings and an .xcframework attached to each release (just xcframework builds them). See DESIGN.md for the architecture, scoring rules, provider gotchas and plans.

Swift 6: the bindings UniFFI 0.32 generates (aspero_ffi.swift) don't yet compile in Swift 6 language mode: its support for async foreign traits (McpHost) passes non-Sendable closures to a Task. Compile that file's target in Swift 5 mode (in SwiftPM, swiftSettings: [.swiftLanguageMode(.v5)]); code using it can stay in Swift 6.

Development

just check runs what CI runs (fmt, the file-size and doc-path gates, clippy, tests); just lists the rest: the live benchmark, fixture recording, a release dry run.

Licence

MIT OR Apache-2.0, at your option.

The bundled citation styles and locales are from the Citation Style Language project, under CC BY-SA 3.0; see crates/bib/styles/NOTICE.md and aspero styles --credits.

The crates aspero is built from keep their own licences: aspero licences lists them, and aspero licences --full prints the third-party notices (each licence text, with the crates under it and their copyright lines). Apps get the same from the FFI's dependencies() and thirdPartyNotices().

from github.com/transilluminate/aspero

Установка Aspero

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/transilluminate/aspero

FAQ

Aspero MCP бесплатный?

Да, Aspero MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Aspero?

Нет, Aspero работает без API-ключей и переменных окружения.

Aspero — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Aspero в Claude Desktop, Claude Code или Cursor?

Открой Aspero на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Opencode Omniroute Plugin

OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc

GitHub Actionsавтор: GitHub Actions
83

Roblox Studio

Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce

paralovавтор: paralov

Antigravity Drawio

MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.

S-SUJAN-Sавтор: S-SUJAN-S

Fetch

Web content fetching and conversion for efficient LLM usage.

автор: Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

modelcontextprotocolавтор: modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.

автор: Community

llm-analysis-assistant

A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also

xuzexin-hzавтор: xuzexin-hz

MCP-Agent

A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)

lastmile-aiавтор: lastmile-ai

Spring AI MCP Client

Provides auto-configuration for MCP client functionality in Spring Boot applications.

автор: Community

mcp.natoma.ai

A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)

автор: Community

Compare Aspero with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории ai