codescout MCP server
Commit 10. Nov. 2026Ermöglicht KI-Coding-Agents Symbol-Navigation, semantische Suche, persistentes Memory und Artifact-Indexing über Multi-Project-Workspaces hinweg.
Auch bekannt als mareurs/codescout
- Stars
- 27
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 10. Nov. 2026
- Lizenz
- MIT
Was ist codescout MCP?
codescout ist ein MCP server. Ermöglicht KI-Coding-Agents Symbol-Navigation, semantische Suche, persistentes Memory und Artifact-Indexing über Multi-Project-Workspaces hinweg.
Zusammenfassung generiert aus dem README des Projekts
Über codescout MCP server
codescout ermöglicht es, KI-Coding-Agents mit Intelligenz auf IDE-Niveau auszustatten, indem es fortschrittliche Symbol-Navigation und semantische Suche bereitstellt. Es fungiert als lokaler MCP server, der sich mit Agents wie Claude Code, GitHub Copilot und Cursor verbindet und es ihnen ermöglicht, komplexe Codebases zu navigieren, ohne ganze Dateien lesen zu müssen. Durch den Einsatz von LSP-basierten Tools wie Symbols, References und Call-Graphs liefert es präzisen Kontext für neun unterstützte Sprachen, darunter Rust, Python und TypeScript.
Entwickler können Multi-Project-Workspaces mithilfe einer workspace.toml-Konfiguration verwalten, um das Memory und Indexing pro Projekt aufrechtzuerhalten. Der Server enthält eine Librarian-Komponente, die Markdown-Artifacts wie Specs, Plans und ADRs in einen SQLite-Katalog indiziert. Für tiefgehende semantische Abfragen unterstützt er einen Retrieval-Stack, der entweder ein lokales ONNX-Modell oder ein externes Qdrant-Setup mit einem Reranker nutzt. Das Tool ist auf Token-Effizienz optimiert und liefert kompakte Details auf Abruf, anstatt große Textmengen in das Context Window des Agents zu werfen.
Was du damit machen kannst
- 1Komplexe Codestrukturen navigierenEin Agent kann spezifische Funktionsdefinitionen oder Call-Sites über die Symbol-Navigation finden, anstatt durch Rohtext zu suchen.
- 2Projektdokumentation abrufenEin Entwickler kann eine KI bitten, alle aktiven Spezifikationen zu einem bestimmten Teil der Retrieval-Pipeline zu finden.
- 3Konzeptbasierte Code-Suche durchführenNutzer können Code anhand seiner zugrunde liegenden Bedeutung lokalisieren, indem sie die semantische Suche nutzen, die durch lokale oder externe Modelle unterstützt wird.
- 4Multi-Project-Kontext verwaltenEntwickler können verwandte Projekte registrieren, damit eine KI über verschiedene Repositories innerhalb eines einzigen Workspaces navigieren kann.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarmareurs/codescout is public and reachablegithub.com/mareurs/codescout ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-10github.com/mareurs/codescout ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehencodescout
MCP server giving AI coding agents IDE-grade code intelligence — symbol navigation, semantic search, persistent memory, workspace-wide artifact tracking — optimized for token efficiency.
📖 Full manual at mareurs.github.io/codescout — installation, agent integrations, every tool, every concept.
Works with Claude Code, GitHub Copilot, Cursor, and any MCP-capable agent.
What it does
- Symbol navigation —
symbols,references,symbol_at,call_graph,edit_code, backed by LSP across 9 languages - Semantic search — find code by concept using a local ONNX model or an external Qdrant + reranker stack
- Library navigation — explore dependency source with scoped search and version tracking
- Artifact tracking (new) — index, query, and link the markdown around your code: specs, plans, ADRs, runbooks, memories. See Artifacts below.
- Multi-project workspaces — register related projects in
workspace.tomlfor cross-project navigation with per-project memory and indexing - Token efficiency — compact by default, details on demand, never dumps full files
Why not just read files?
| Without codescout | With codescout |
|---|---|
| Agent reads full files to find one function | Navigates by symbol name — zero file reads |
grep returns noise (comments, strings, docs) |
references returns exact call sites |
| Context burns on navigation overhead | Token-efficient by design |
| State lost between sessions | Persistent memory + artifact catalog across sessions |
| Re-reads same modules from different entry points | Symbol index built once, queried instantly |
Quick Start
cargo build
./target/debug/codescout start --project /path/to/code
Register as an MCP server in ~/.claude/settings.json:
{
"mcpServers": {
"codescout": {
"command": "codescout",
"args": ["start", "--project", "."]
}
}
}
Onboarding is essential. Run
onboarding()once per project on first connect — it discovers languages, reads key files, and generates a project-specific system prompt and memory files. Without it, the agent navigates blind.Tip: Install the codescout-companion plugin to auto-steer Claude toward codescout tools in every session — including subagents.
→ Full setup, agent configs, and project-toml options: mareurs.github.io/codescout
Artifacts
codescout now embeds librarian — a workspace-wide artifact registry that indexes the markdown around your code (specs, plans, ADRs, runbooks, memories, audits, handoffs, roadmaps, user docs), stores metadata + a typed link graph in SQLite, and exposes it to the agent as queryable structured data instead of opaque file listings.
Why it matters. The code is half the project. The other half lives in
markdown files scattered across docs/, design notes, and runbooks. Without
indexing them, the agent re-discovers project history every session. With
librarian, "find every active spec touching the embedder" is a single tool call.
How it works.
- Every markdown file is classified by frontmatter or path-rule into a kind
(spec / plan / adr / runbook / memory / tracker / doc / ...) and indexed
into a SQLite catalog at
~/.local/share/librarian/catalog.db. - A typed link graph (
supersedes,implements,references, ...) connects artifacts; walk it transitively withartifact(action="graph"). - A 4-tier scope ladder (
project→repo→umbrella→all) lets the agent widen beyond the current sub-project on demand. - Optional semantic search via
LIBRARIAN_EMBED_*turnsartifact(action="find", semantic="…")into vector search.
How to use it.
# Find every active spec touching the retrieval stack
artifact(action="find", kind="spec", status="active", semantic="retrieval pipeline")
# Read one, with its outgoing link graph
artifact(action="get", id="abc123", include_links=true)
# Connect a plan to the spec it implements
artifact(action="link", src_id="<plan>", dst_id="<spec>", rel="implements")
# Pack a topic neighbourhood into a single markdown bundle for context
librarian(action="context", topic="hybrid sparse + dense retrieval", max_tokens=4000)
Trackers — augment any artifact with a persistent prompt + params, and codescout auto-refreshes it on demand. Friction logs, observation tables, sprint roadmaps — written once, maintained across sessions.
Embedded by default. No separate server to install. Opt out with
LIBRARIAN_ENABLED=0 for a leaner tool surface.
→ Full artifact guide: librarian embedded · trackers · time-travel · augmentation templates
Retrieval Stack
semantic_search runs through an external Docker Compose stack (Qdrant +
dense embedder + SPLADE sparse + cross-encoder rerank). Two profiles: cpu
and gpu.
docker compose --profile cpu --env-file .env.cpu up -d
# or --profile gpu --env-file .env.gpu
set -a; source .env.cpu; set +a
cargo run --release --bin sync_project -- . codescout
| Profile | Initial sync (~18k chunks) | Sustained throughput |
|---|---|---|
| cpu (llama-server, 4 threads) | ~125 min | 2.4 chunks/s |
| gpu (llama-server-cuda, RTX A5000) | ~2.6 min | 117-132 chunks/s |
→ Stack setup, model choices, and tuning
Agent integrations
| Agent | Guide |
|---|---|
| Claude Code | mareurs.github.io/codescout/agents/claude-code |
| GitHub Copilot | mareurs.github.io/codescout/agents/copilot |
| Cursor | mareurs.github.io/codescout/agents/cursor |
Multi-agent infrastructure
codescout's design is informed by research on compound error in multi-agent systems — failure rates of 41–87% in production pipelines. This drove the choice of single-session skill-based workflows over agent orchestration chains. Read the analysis →
Guidance that agents actually follow
codescout's prompt surfaces — Iron Laws, get_guide topics, tracker rendering,
result envelopes — are shaped by measured findings on how coding agents trust,
follow, and resist the content a tool surfaces. The short version: authority framing
(a persona, a "trusted" marker) buys nothing; placement and server-computed
provenance buy everything. Trust attaches to what the server computes
(symbols, git state, freshness keys), never to a marker the content carries about
itself — because anything in a file body is forgeable by whoever wrote the file.
Read the findings →
Kotlin & Rust LSP multiplexers
Kotlin and Rust LSPs are expensive to boot and allow only one process per
workspace. codescout ships per-language multiplexers — a detached codescout mux process shares one LSP across all codescout instances. Cold-start happens
once; subsequent sessions connect instantly. No configuration needed.
| Metric | Without mux | With mux |
|---|---|---|
| LSP processes per machine | 1 per session (~2GB each) | 1 shared |
| Cold start on 2nd session | 8–15s | ~0s |
→ Kotlin LSP multiplexer · Rust
Tools
Symbol navigation · File operations · Shell · Semantic search · Memory · Library navigation · Artifacts · Workflow & Config
Supported languages: Rust, Python, TypeScript/JavaScript, Go, Java, Kotlin, C/C++, C#, Ruby.
Experimental Features
New features land on experiments before reaching master. They may change
or be removed without notice.
→ Browse experimental features
Contributing
See CONTRIBUTING.md. PRs from Claude Code are welcome.
License
codescout MCP Fragen
Welche Sprachen unterstützt codescout für die Symbol-Navigation?
Es unterstützt Rust, Python, TypeScript/JavaScript, Go, Java, Kotlin, C/C++, C# und Ruby über LSP-basierte Symbol-Tools.
Muss ich einen separaten Server für die Code-Suche ausführen?
Die semantische Suche kann ein lokales ONNX-Modell nutzen oder einen externen Docker Compose Stack mit Qdrant, einem Sparse Embedder und einem Reranker. Das Artifact-Registry ist eingebettet und benötigt keinen separaten Server.
Was macht die Artifact-Tracking-Funktion?
Sie indiziert Markdown-Dateien wie Specs, Plans, ADRs und Runbooks in einen SQLite-Katalog mit einem typisierten Link-Graph, sodass der Agent sie in einzelnen Tool-Calls finden und verknüpfen kann.
Wie richte ich codescout mit Claude Code ein?
Registriere es als MCP server in deiner Settings-Datei und führe dann einmal pro Projekt onboarding() aus, damit der Agent Sprachen und wichtige Dateien entdecken kann.
Funktioniert codescout mit einem Multi-Project-Workspace?
Ja; du registrierst verwandte Projekte in der workspace.toml, um eine projektübergreifende Navigation mit Memory und Indexing pro Projekt zu erhalten.