Skip to content
MCP server

AsterMind MCP

Local MCP server that reranks and trims RAG context to cut tokens before an LLM call

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI
Runs
Locally
Version
0.1.0
Listing updated
today

About AsterMind MCP

AsterMind MCP is a free MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

AsterMind MCP works on the retrieval side of a RAG pipeline. You hand it candidate passages and a query, and it scores them locally so you only forward the few that matter. The README says it runs on the AsterMind Community Edition ELM engine with no network calls, no API keys and no data leaving the machine.

The project publishes its own numbers: on a six-scenario benchmark that cut 10 candidates down to the top 3, average context-token saving was 66.9% and a passage containing the answer survived in every scenario. It is equally frank about the trade-off: strict recall of all relevant passages was 55.6%, so multi-hop questions should keep five or six chunks.

The README lists known limits openly. Reranking is lexical (TF-IDF), so pure synonym gaps can be missed; classification is weak out of the box; embeddings are character-level and suit near-duplicate detection rather than deep semantic similarity. It runs on Node 18+ with no GPU.

Install

Run in a terminal

claude mcp add astermind-mcp -- npx -y @astermind/astermind-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "astermind-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@astermind/astermind-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "astermind-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@astermind/astermind-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "astermind-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@astermind/astermind-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "astermind-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@astermind/astermind-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "astermind-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@astermind/astermind-mcp"
      ]
    }
  }
}

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

rerank_documents
Score and order candidates against a query
filter_context
Keep the top-K or above-threshold passages
compress_context
Rerank and trim a context block to a token budget
count_tokens
Exact BPE token count for any text
estimate_savings
Before/after token delta for a filtering choice
semantic_search
Rank a corpus against a query
detect_language
Identify the language of text
classify_text
Label text into supplied categories
generate_embeddings
Character-level vector for text
compare_texts
Similarity between two texts

What it does

Context reranking
rerank_documents scores and orders candidate passages against a query.
Context filtering
filter_context keeps the top-K or above-threshold passages.
Token-budget compression
compress_context reranks and trims a block to fit a token budget.
Token accounting
count_tokens and estimate_savings give BPE counts and before/after deltas.
Confidence signals
Every tool returns a confidence flag and says when the engine is weak.

Good for

  • Cut the retrieved context sent to an LLM in a support-KB RAG pipeline
  • Estimate token savings before choosing how many chunks to keep
  • Detect near-duplicate passages in a corpus
  • Fit retrieved text into a fixed token budget before prompting

Pricing

Free

No API key needed; runs locally

Prices change. Check astermindai.com before you buy.

AsterMind MCP FAQ

Does any data leave my machine?

The README says there are no network calls and no API keys; processing is local.

How much context does it save?

On the project's six-scenario benchmark, keeping the top 3 of 10 passages saved 66.9% of tokens on average.

What are the main limitations?

The reranker is lexical, classification is weak, and embeddings are character-level.

How do I run it?

With npx @astermind/astermind-mcp on Node 18+, or by adding the same command to an MCP client config.

Is AsterMind MCP free?

Yes. AsterMind MCP is free to use.

How do I add AsterMind MCP to Claude Code?

Run this command in your terminal: claude mcp add astermind-mcp -- npx -y @astermind/astermind-mcp

What are the best alternatives to AsterMind MCP?

The closest alternatives to AsterMind MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to AsterMind MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools