Skip to main content

Code intelligence MCP server for token-efficient code retrieval, analysis, and refactoring

Project description

Sylvan

Tests PyPI Python Downloads License Code style: Ruff Docs MCP

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 58 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

Overview

More screenshots

Search - find code by name, signature, or keywords with syntax-highlighted source Search

Session - live token efficiency tracking per session and all-time Session

Quality Report - code smells, security findings, test/doc coverage Quality

Blast Radius - visualize impact before changing a symbol Blast Radius

Libraries - indexed third-party packages with symbol counts Libraries

Features

  • 65 MCP tools for search, browsing, analysis, memory, and refactoring
  • 40 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.

Token cost

Sylvan loads ~9,200 tokens of tool descriptions into your agent's context at session start. See TRANSPARENCY.md for full breakdown, real-world numbers, and what we do not do.

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sylvan-1.10.1.tar.gz (517.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sylvan-1.10.1-py3-none-any.whl (721.0 kB view details)

Uploaded Python 3

File details

Details for the file sylvan-1.10.1.tar.gz.

File metadata

  • Download URL: sylvan-1.10.1.tar.gz
  • Upload date:
  • Size: 517.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for sylvan-1.10.1.tar.gz
Algorithm Hash digest
SHA256 e52f19d80b7b90f2d0e9f6f68c7bfda3ea73480dbad486946f2c1a41bc742c64
MD5 7f2c7c442fc775cbc6620db328976075
BLAKE2b-256 8fe9a13057f7e2c55ccb67cbb0cfa7ecb9cb8a227ab341bebefea9e9d0ecc8b6

See more details on using hashes here.

Provenance

The following attestation bundles were made for sylvan-1.10.1.tar.gz:

Publisher: publish.yml on darki73/sylvan

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file sylvan-1.10.1-py3-none-any.whl.

File metadata

  • Download URL: sylvan-1.10.1-py3-none-any.whl
  • Upload date:
  • Size: 721.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for sylvan-1.10.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b994ddf68c61c74e9e743e3f93f6a32f83698ada7401af44ad053c81469a1698
MD5 dc38bbe5f36bdce03c6a4087a78d053b
BLAKE2b-256 64904c7adaea411da17ca1399402780c7a93af4fefa0dff05868c819d5ead802

See more details on using hashes here.

Provenance

The following attestation bundles were made for sylvan-1.10.1-py3-none-any.whl:

Publisher: publish.yml on darki73/sylvan

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page