Prelude MCP server

by adjective-rob·io.github.adjective-rob/prelude·v1.11.0·5 stars

No reviews yet

Committed, machine-readable codebase context and code map that tells agents where to look.

B74/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B74/100

full report

Adoption

Growing

5 stars146 downloads/wk

Reviews

Write one

Nobody has reviewed Prelude yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Prelude tools (10)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

prelude_annotate_module
Correct or enrich what the map says about a module. Set `purpose` when the inferred purpose is wrong or missing; add `notes` for anything a future agent should know about this directory (gotchas, entry points, ownership). Manual purposes are never overwritten by prelude update.
prelude_compact
Get compact, token-efficient context for LLM prompt injection. Returns flat prefixed lines.
prelude_link_projects
Record how two projects relate so future sessions know the contract between them. Writes to the `from` project's project.json. Example: from=frontend, to=backend, relation=consumes, contract='REST /api/v1 with Supabase JWT bearer; see backend CLAUDE.md for routes'.
prelude_locate
Find the files most relevant to a task before reading or grepping. Give a short phrase describing what you need to change or understand (e.g. 'billing checkout webhook', 'where manual edits are preserved'). Searches names, paths, and file contents, and returns ranked files with the reason each matched. Each result also carries what a text search cannot: how many files import it, the tests that cov
prelude_map
Inspect the code map. With no arguments, returns the hub files to read first and a one-line summary of every module. With `module`, returns that module's purpose, notes, dependencies, tests, and files with exports. With `file`, returns that file's exports, resolved imports, importers count, and the module it belongs to.
prelude_projects
List every project registered in this workspace with its purpose, stack, entry points, API surface, hub files, and relationships to other projects. Call this first in any session that may touch more than one codebase, then use the returned name as the `project` argument on other tools.
prelude_query
Query project context by topic, scope, or type. Returns structured context about the codebase.
prelude_record_decision
Record an architectural decision in .context/decisions.json so future sessions inherit it. Use this whenever you choose between approaches, adopt or reject a library, or establish a convention. Keep the title under 80 characters and put the reasoning in rationale.
prelude_status
Check Prelude status — which context files exist and basic project info.
prelude_workspace_refresh
Rebuild the workspace index after adding projects or running prelude update in one of them.

Public scan report

scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it

1 high

Code scan120 source files scanned13/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 10 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Findings (1)

highShell command built from a string (injection risk)exec.shell-concat

dist/src/commands/export.js: …mandExists(command) { try { execSync(`which ${command}`, { stdio: 'ignore' }); …

Overall 74/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Prelude compares

Against every graded Maps and travel MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 74/100; higher than 44% of 681 Maps and travel servers
Tools: 10; the typical Maps and travel server has 6
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 5; more than 85% of 324 Maps and travel servers
Downloads a week: 146; more than 75% of 150 Maps and travel servers with a package

What its tools let an agent do: 10 read

Install Prelude in Claude Code, Cursor or VS Code

Runs npx -y prelude-context on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add prelude -- npx -y prelude-context

Add to Cursor

What the publisher says

From the Prelude repository's README, as published. We do not edit it. Read it on GitHub

Prelude

Project memory and a code map for AI agents: where to look, why the code is the way it is, and what a change will touch.

An agent with grep can find where a word appears. It cannot find out why the code is shaped the way it is, which tests cover a file, how many other files depend on it, or what the last session learned. That knowledge isn't in the source.

Prelude keeps it in the repo. It scans the project once and writes a small set of JSON files to .context/: the stack, the architecture, the constraints, the decisions, and a code map of every module, its exports, and what imports what. You commit those files, and agents add to them as they work. Every later session starts from them, through an MCP server, a generated CLAUDE.md / AGENTS.md, or plain stdout.

No embeddings, no server to host, no network calls. Regex heuristics over TypeScript/JavaScript, Python, Go, and Rust.

Quick start

cd your-project
npx prelude-context init        # writes .context/

Or install it, which gives you the prelude command used in the rest of this README:

npm install -g prelude-context
prelude init

Then give it a task phrase:

prelude locate preserve manual edits during update --limit 2

1. src/core/merger.ts  ·  src/core (Core business logic)  ·  score 32
   exports: MergeResult, MergeChange, ContextMerger, trackMapFields
   why: decision: Manual edits are sacred, content preserve×25, manual×31, edit×9, update×6, matches all terms
   impact: imported by 4 files  ·  tests: tests/map-merge.test.ts, tests/mcp-server.test.ts, tests/merge-preserve.test.ts
   decisions: Manual edits are sacred
2. src/core/state-manager.ts  ·  src/core (Core business logic)  ·  score 26
   exports: StateManager
   why: decision: Manual edits are sacred, content manual×9, edit×4, update×6, matches all terms
   impact: imported by 7 files  ·  tests: tests/map-merge.test.ts, tests/mcp-server.test.ts, tests/merge-preserve.test.ts
   decisions: Manual edits are sacred

One call returns the files to read, why each was picked, what depends on them, the tests to run afterwards, and the recorded decision that constrains the change. That is real output from this repository, which keeps its own .context/ committed. Browse it to see what Prelude writes.

Requires Node.js >= 20.19.

What you get

your-project/
└── .context/
    ├── project.json        what the project is
    ├── stack.json          language, runtime, frameworks, tooling
    ├── architecture.json   type, patterns, directories, entry points, routes
    ├── constraints.json    rules and preferences
    ├── decisions.json      architecture decisions and their rationale
    ├── map.json            modules, exports, import graph, hub files
    ├── changelog.md        project timeline
    └── .prelude/           state: which fields were inferred, which you edited

Commit .context/. Gitignore .context/*.session.json.

prelude compact prints the whole thing as one dense line per section, sized for a system prompt (a few hundred tokens for this repo):

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Prelude: common questions

Is Prelude MCP server safe?: Mostly: it is graded B (74/100). Read the Prelude safety report
How do I install Prelude?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Prelude need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Prelude maintained?: The last commit was 30 days ago (2026-10-04). The latest release is v1.11.0.
What can I use instead of Prelude?: Servers from other publishers that do the same job: Repo Graph MCP server, Agentmap MCP server and Infranodus Infranodus MCP server.
How does Prelude compare with other Maps and travel MCP servers?: safety score 74/100 (higher than 44% of 681 Maps and travel servers); tools 10 (the typical Maps and travel server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Prelude

Same job from other publishers: the closest match first, then the best rated.

Repo Graph
Structural graph map of any codebase so LLMs navigate by structure, not guesswork.
not reviewed
Growing
A
Agentmap
The TS/JS-accurate repo map for coding agents: ts-morph import/symbol/call graph + MCP query tools
not reviewed
Growing
A
Infranodus Infranodus
Map text into knowledge graphs to create a structured representation of conceptual relations and t…
not reviewed
Growing
A
Openchargemap
Find EV charging stations, detail, and reliability check-ins via the global Open Charge Map.
not reviewed
Growing
A
Trips
Hand someone a complete trip as a private, editable map link. No account, no API key, no card.
not reviewed
Growing
A