codescout MCPサーバー
コミット 2026年11月10日AIコーディングエージェントに対し、マルチプロジェクト・ワークスペースにわたるシンボルナビゲーション、セマンティック検索、永続メモリ、およびアーティファクトのインデックス作成機能を提供します。
別名 mareurs/codescout
- スター
- 27
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月10日
- ライセンス
- MIT
codescout MCPとは
codescoutはMCPサーバーです。 AIコーディングエージェントに対し、マルチプロジェクト・ワークスペースにわたるシンボルナビゲーション、セマンティック検索、永続メモリ、およびアーティファクトのインデックス作成機能を提供します。.
プロジェクトのREADMEから生成された概要
codescout MCP server について
codescoutは、高度なシンボルナビゲーションとセマンティック検索を通じて、AIコーディングエージェントにIDEレベルのインテリジェンスを提供します。これはローカルのMCP serverとして機能し、Claude Code、GitHub Copilot、Cursorなどのエージェントと接続することで、ファイル全体を読み込むことなく複雑なコードベースをナビゲートすることを可能にします。シンボル、参照、コールグラフなどのLSPベースのツールを使用することで、Rust、Python、TypeScriptを含むサポートされている9つの言語にわたって正確なコンテキストを提供します。
開発者は workspace.toml 設定を使用してマルチプロジェクト・ワークスペースを管理し、プロジェクトごとのメモリとインデックスを維持できます。このサーバーには、仕様書、計画書、ADRなどのMarkdownアーティファクトをSQLiteカタログにインデックス化するライブラリアンコンポーネントが含まれています。深いセマンティック検索のために、ローカルのONNXモデル、またはリランカーを備えた外部の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、スパースエンベッダー、リランカーを含む外部のDocker Composeスタックを使用できます。アーティファクトレジストリは組み込み型のため、別途サーバーを用意する必要はありません。
アーティファクト追跡機能とは何ですか?
仕様書、計画書、ADR、ランブックなどのMarkdownファイルを、型付きリンクグラフを持つSQLiteカタログにインデックス化します。これにより、エージェントは単一のツール呼び出しでそれらを見つけ、関連付けることができます。
Claude Codeでcodescoutをセットアップするにはどうすればよいですか?
設定ファイルでMCP serverとして登録した後、プロジェクトごとに一度 onboarding() を実行してください。これにより、エージェントが言語や主要なファイルを認識できるようになります。
codescoutはマルチプロジェクト・ワークスペースで動作しますか?
はい。workspace.toml に関連プロジェクトを登録することで、プロジェクトごとのメモリとインデックスを維持しながら、プロジェクトをまたいだナビゲーションが可能になります。