Unified code + documentation retrieval MCP server
Project description
Sylvan
Code intelligence platform for AI agents. Search, analyze, and navigate codebases through MCP tools - returning exactly the code your agent needs at a fraction of the token cost.
Why
AI agents burn tokens reading entire files when they need one function. They grep across directories to trace a dependency. They piece together call chains one file at a time. Every wasted read costs money and context window space.
Sylvan indexes your codebase into a structured database of symbols, sections, and import relationships, then exposes it through 57 MCP tools. Your agent asks for what it needs and gets exactly that - function signatures, blast radius, dependency graphs, semantic search results. Typical token savings exceed 80%.
Dashboard
More screenshots
Search - find code by name, signature, or keywords with syntax-highlighted source
Session - live token efficiency tracking per session and all-time
Quality Report - code smells, security findings, test/doc coverage
Blast Radius - visualize impact before changing a symbol
Libraries - indexed third-party packages with symbol counts
Features
- 57 MCP tools for search, browsing, analysis, and refactoring
- 34 programming languages via tree-sitter
- Hybrid search - full-text (FTS5) + vector similarity with ranked fusion
- Blast radius analysis before any refactor
- Dependency graphs, call chains, class hierarchies
- Third-party library indexing (pip, npm, cargo, go)
- Multi-repo workspaces with cross-repo analysis
- Code quality reports - smells, security, duplication, dead code
- Web dashboard with live token efficiency tracking
- Multi-instance cluster support
Quick start
uv tool install sylvan
Add to your MCP client config:
{
"mcpServers": {
"sylvan": {
"command": "sylvan",
"args": ["serve"]
}
}
}
Your agent handles the rest - index a project, search for code, navigate with precision.
Upgrading to 1.8.0? Run a full re-index from the dashboard to build the call graph and repo briefing for existing repos.
Documentation
Full docs at darki73.github.io/sylvan
License
Non-commercial open source. Free to use, modify, and distribute with attribution. See LICENSE for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sylvan-1.8.0.tar.gz.
File metadata
- Download URL: sylvan-1.8.0.tar.gz
- Upload date:
- Size: 474.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5529c4b4cd7b455f757fc512ac923459a32d84e6ca15869a0aeff0c020c4a36e
|
|
| MD5 |
a159e2bada47e20b9fc35a197feb91ab
|
|
| BLAKE2b-256 |
221b1bbf6afbb632f4fbe3e6bb75faecd835f24446d9ef27dd09384b3af4f17b
|
Provenance
The following attestation bundles were made for sylvan-1.8.0.tar.gz:
Publisher:
publish.yml on darki73/sylvan
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sylvan-1.8.0.tar.gz -
Subject digest:
5529c4b4cd7b455f757fc512ac923459a32d84e6ca15869a0aeff0c020c4a36e - Sigstore transparency entry: 1203468963
- Sigstore integration time:
-
Permalink:
darki73/sylvan@899de480992eb79f1ba8f3c71ac8552b68e647fc -
Branch / Tag:
refs/tags/v1.8.0 - Owner: https://github.com/darki73
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@899de480992eb79f1ba8f3c71ac8552b68e647fc -
Trigger Event:
push
-
Statement type:
File details
Details for the file sylvan-1.8.0-py3-none-any.whl.
File metadata
- Download URL: sylvan-1.8.0-py3-none-any.whl
- Upload date:
- Size: 649.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b2e2adc8ba988e4980c9ab3dd8c9d300f72ca929d3825a6df514346c8ae60868
|
|
| MD5 |
9dfb96a119ba29badcaf5bf06953f1fb
|
|
| BLAKE2b-256 |
1b4cdbd4cf74c641543b7dcff8677d131b3587d6a07a0d7c7116adb9fd006b88
|
Provenance
The following attestation bundles were made for sylvan-1.8.0-py3-none-any.whl:
Publisher:
publish.yml on darki73/sylvan
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sylvan-1.8.0-py3-none-any.whl -
Subject digest:
b2e2adc8ba988e4980c9ab3dd8c9d300f72ca929d3825a6df514346c8ae60868 - Sigstore transparency entry: 1203468966
- Sigstore integration time:
-
Permalink:
darki73/sylvan@899de480992eb79f1ba8f3c71ac8552b68e647fc -
Branch / Tag:
refs/tags/v1.8.0 - Owner: https://github.com/darki73
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@899de480992eb79f1ba8f3c71ac8552b68e647fc -
Trigger Event:
push
-
Statement type: