codescout MCP server
2026년 11월 10일 커밋AI 코딩 에이전트에게 심볼 탐색, 시맨틱 검색, 지속성 메모리 및 멀티 프로젝트 워크스페이스 전반의 아티팩트 인덱싱 기능을 제공합니다.
다른 이름 mareurs/codescout
- 스타
- 27
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 10일
- 라이선스
- MIT
codescout MCP란?
codescout은(는) MCP server입니다. AI 코딩 에이전트에게 심볼 탐색, 시맨틱 검색, 지속성 메모리 및 멀티 프로젝트 워크스페이스 전반의 아티팩트 인덱싱 기능을 제공합니다.
프로젝트 README에서 생성된 요약
codescout MCP server 정보
codescout은 고급 심볼 탐색과 시맨틱 검색을 통해 AI 코딩 에이전트에게 IDE 수준의 지능을 제공합니다. Claude Code, GitHub Copilot, Cursor와 같은 에이전트에 연결되는 로컬 MCP server로 작동하며, 에이전트가 전체 파일을 읽지 않고도 복잡한 코드베이스를 탐색할 수 있도록 돕습니다. 심볼, 참조, 콜 그래프와 같은 LSP 기반 도구를 사용하여 Rust, Python, TypeScript를 포함한 9가지 지원 언어에 대해 정밀한 컨텍스트를 제공합니다.
개발자는 workspace.toml 설정을 사용하여 멀티 프로젝트 워크스페이스를 관리하고 프로젝트별 메모리 및 인덱싱을 유지할 수 있습니다. 이 서버에는 사양서, 계획서, ADR과 같은 마크다운 아티팩트를 SQLite 카탈로그로 인덱싱하는 librarian 구성 요소가 포함되어 있습니다. 심층적인 시맨틱 검색을 위해 로컬 ONNX 모델 또는 reranker가 포함된 외부 Qdrant 설정을 사용하는 검색 스택을 지원합니다. 대량의 텍스트를 에이전트의 컨텍스트 윈도우에 쏟아붓는 대신, 필요할 때마다 압축된 세부 정보를 제공하도록 설계되어 토큰 효율성이 높습니다.
활용 사례
- 1복잡한 코드 구조 탐색에이전트가 원시 텍스트를 검색하는 대신 심볼 탐색을 사용하여 특정 함수 정의나 호출 지점을 찾을 수 있습니다.
- 2프로젝트 문서 검색개발자가 AI에게 데이터 검색 파이프라인의 특정 부분과 관련된 모든 활성 사양서를 찾아달라고 요청할 수 있습니다.
- 3개념 기반 코드 검색 수행사용자는 로컬 또는 외부 모델 기반의 시맨틱 검색을 사용하여 코드의 근본적인 의미를 바탕으로 코드를 찾을 수 있습니다.
- 4멀티 프로젝트 컨텍스트 관리개발자가 관련 프로젝트를 등록하여 AI가 단일 워크스페이스 내에서 서로 다른 저장소를 넘나들며 탐색할 수 있도록 합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능mareurs/codescout is public and reachablegithub.com/mareurs/codescout ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-10github.com/mareurs/codescout ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기codescout
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 질문
심볼 탐색을 위해 어떤 언어를 지원하나요?
LSP 기반 심볼 도구를 통해 Rust, Python, TypeScript/JavaScript, Go, Java, Kotlin, C/C++, C#, Ruby를 지원합니다.
코드 검색을 위해 별도의 서버를 실행해야 하나요?
시맨틱 검색은 로컬 ONNX 모델을 사용하거나, Qdrant, sparse embedder, reranker가 포함된 외부 Docker Compose 스택을 사용할 수 있습니다. 아티팩트 레지스트리는 내장되어 있어 별도의 서버가 필요하지 않습니다.
아티팩트 트래킹 기능은 무엇을 하나요?
사양서, 계획서, ADR, 런북과 같은 마크다운 파일을 타입화된 링크 그래프가 포함된 SQLite 카탈로그로 인덱싱하여, 에이전트가 단일 도구 호출로 이를 찾고 연결할 수 있게 합니다.
Claude Code에서 codescout을 어떻게 설정하나요?
설정 파일에 MCP server로 등록한 다음, 프로젝트마다 onboarding()을 한 번 실행하여 에이전트가 언어와 주요 파일을 탐색할 수 있도록 합니다.
codescout은 멀티 프로젝트 워크스페이스에서도 작동하나요?
네, workspace.toml에 관련 프로젝트를 등록하면 프로젝트별 메모리 및 인덱싱과 함께 프로젝트 간 탐색이 가능합니다.