# Code Tree

> A CLI tool and MCP server for quickly exploring project structure and codebase

- **Type:** MCP server
- **Install:** `agentstack add mcp-febalist-code-tree`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [febalist](https://agentstack.voostack.com/s/febalist)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** ISC
- **Upstream author:** [febalist](https://github.com/febalist)
- **Source:** https://github.com/febalist/code-tree
- **Website:** https://www.npmjs.com/package/@febalist/code-tree

## Install

```sh
agentstack add mcp-febalist-code-tree
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# code-tree

[](https://www.npmjs.com/package/@febalist/code-tree)
[](https://github.com/febalist/code-tree/actions/workflows/ci.yml)

A CLI tool and MCP server for quickly exploring project structure and codebase.

**Requirements:** Bun

## Features

- 🌳 Directory structure scanning (like `tree`)
- 🔍 Code symbol extraction: classes, functions, interfaces, types
- 📝 Doc comment support
- 🚀 Accurate AST parsing via Tree-sitter (WASM)
- 🎯 10+ programming languages + Markdown
- ⚡ Automatic output optimization

## Installation

```bash
# Global installation
bun add -g @febalist/code-tree

# Or use with bunx (no installation needed)
bunx @febalist/code-tree .
```

## Usage

```bash
# Scan current directory
code-tree .

# Scan specific directory
code-tree src/

# Parse specific file
code-tree src/index.ts

# Multiple paths
code-tree src/ lib/

# With options
code-tree --depth 2 --no-symbols .
code-tree --ignore "*.test.ts" --ignore "*.spec.ts" src/

# Help
code-tree --help
```

## Parameters

- **Positional arguments**: Paths to directories or files (default: `.`)
- `--depth `: Maximum traversal depth (default: 10)
- `--symbols` / `--no-symbols`: Include/exclude code symbols (default: auto)
- `--comments` / `--no-comments`: Include/exclude doc comments (default: auto)
- `--ignore `: Additional ignore patterns (repeatable)

## Output Examples

**Directory with symbols:**
```
src/
├── index.ts
│     async run(args)
├── parser/
│   ├── index.ts
│   │     class ParserManager
│   │       async init()
│   │       private async loadLanguage(config: LanguageConfig): Promise
│   │       async parseFile(filePath: string): Promise
│   └── types.ts
│         type SymbolKind
│         interface CodeSymbol
│         interface FileSymbols
```

**File with detailed breakdown:**
```
src/parser/index.ts

  class ParserManager
    async init()
      locateFile()
    private async loadLanguage(config: LanguageConfig): Promise
    async parseFile(filePath: string): Promise
```

## Supported Languages

- TypeScript (.ts, .tsx)
- JavaScript (.js, .jsx, .mjs, .cjs)
- Python (.py, .pyw)
- Go (.go)
- PHP (.php)
- Rust (.rs)
- Java (.java)
- C# (.cs)
- Ruby (.rb)
- Kotlin (.kt, .kts)
- Swift (.swift)
- C/C++ (.c, .h, .cpp, .hpp, .cc, .cxx, .hh, .hxx)
- Markdown (.md, .mdx)

## File Ignoring

Automatically ignored:

- `.git`, `.svn`, `.hg`, `.DS_Store` (always)
- `node_modules`, `vendor`, `dist`, `build`, `__pycache__`, `venv`, `target`, `bin`, `obj`, `coverage`
- Patterns from `.gitignore`
- Custom patterns via `--ignore` parameter

## MCP Server

`code-tree` also provides an MCP (Model Context Protocol) server for integration with LLM clients like Claude Code.

The MCP server exposes the same capabilities and parameters as the CLI.

### Integration Example

Add to Claude Code MCP configuration:

```json
{
  "mcpServers": {
    "code-tree": {
      "command": "bunx",
      "args": ["@febalist/code-tree", "mcp"]
    }
  }
}
```

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [febalist](https://github.com/febalist)
- **Source:** [febalist/code-tree](https://github.com/febalist/code-tree)
- **License:** ISC
- **Homepage:** https://www.npmjs.com/package/@febalist/code-tree

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-febalist-code-tree
- Seller: https://agentstack.voostack.com/s/febalist
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.