alexei.dolgolyov
c3eb50f326
Documents install on macOS/Linux (Homebrew) and Windows (cargo build from source — no prebuilt Windows binary in v1.5.0). Includes per-project bootstrap (.vex.toml with semantic + auto_update, vex index) and the vex-mcp registration at user scope so it covers all projects.
146 lines
7.2 KiB
Markdown
146 lines
7.2 KiB
Markdown
# Claude Code Tools & Extensions
|
||
|
||
Useful tools, plugins, and extensions for Claude Code.
|
||
|
||
## MCP Servers
|
||
|
||
MCP (Model Context Protocol) servers are external processes that provide tools to Claude Code via a standardized protocol. They run alongside your session and extend Claude's capabilities.
|
||
|
||
### Context7
|
||
|
||
Up-to-date documentation and code examples for any library, available directly in your Claude Code session.
|
||
|
||
- **Website:** <https://context7.com/>
|
||
- **Setup:**
|
||
|
||
```bash
|
||
claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: <YOUR_API_KEY>"
|
||
```
|
||
|
||
- **Note:** API key can be created for free after signing in at [context7.com](https://context7.com/)
|
||
|
||
### code-review-graph
|
||
|
||
Builds a Tree-sitter–based structural graph of the codebase (callers, callees, imports, tests, blast radius) and exposes it as an MCP server. Lets Claude scope reviews to the minimal affected set instead of scanning whole projects — the project README reports ~8x fewer tokens on code reviews and up to ~49x on daily tasks.
|
||
|
||
- **Repository:** <https://github.com/tirth8205/code-review-graph>
|
||
- **Setup:**
|
||
|
||
```bash
|
||
pip install code-review-graph
|
||
code-review-graph install # auto-configures Claude Code / Cursor / Windsurf
|
||
```
|
||
|
||
Then restart the editor and build the graph for the current repo via the `build_or_update_graph_tool`.
|
||
|
||
- **Languages:** 23+ including Python, TypeScript/JavaScript, Go, Rust, Java, plus Jupyter notebooks.
|
||
- **Key tools:** `detect_changes`, `get_review_context`, `get_impact_radius`, `get_affected_flows`, `query_graph`, `semantic_search_nodes`, `get_architecture_overview`.
|
||
|
||
### VS MCP Server (Visual Studio)
|
||
|
||
Visual Studio 2022/2026 extension that exposes the IDE itself over MCP — solutions/projects, document I/O, editor navigation, build status, debugging (breakpoints, stepping, variable inspection), error list, and window control. Useful when working on .NET/C++ solutions where Claude Code needs to drive the actual Visual Studio session rather than just edit files on disk.
|
||
|
||
- **Marketplace:** <https://marketplace.visualstudio.com/items?itemName=CodingWithCalvin.VS-MCPServer>
|
||
- **Setup:** Install from **Extensions → Manage Extensions** in Visual Studio (search "MCP Server"), or download the `.vsix`. Start via **Tools → MCP Server → Start Server** (defaults to `http://localhost:5050`).
|
||
- **Note:** This is a *Visual Studio* extension, not VS Code — despite the `marketplace.visualstudio.com` URL, which hosts both.
|
||
|
||
## Skills (Slash Commands)
|
||
|
||
Skills are a different extension mechanism from MCPs. They are prompt-based extensions invoked via `/skill-name` commands directly within Claude Code — no external server required.
|
||
|
||
### Installing `.skill` packages
|
||
|
||
Skills are distributed as `.skill` files (ZIP archives containing a `SKILL.md` and optional scripts).
|
||
|
||
**Manual extraction** (works everywhere, including VS Code extension):
|
||
|
||
```bash
|
||
# Python one-liner
|
||
python -c "import zipfile; zipfile.ZipFile('my-skill.skill').extractall('$HOME/.claude/skills')"
|
||
```
|
||
|
||
Skills are extracted into `~/.claude/skills/<skill-name>/`. They become available in the next Claude Code session.
|
||
|
||
### AST Index
|
||
|
||
Fast code search skill for Claude Code — find classes, symbols, usages, implementations, and more across large codebases using AST parsing.
|
||
|
||
- **Repository:** <https://github.com/defendend/Claude-ast-index-search>
|
||
- **Usage:** Invoke with `/ast-index` or related commands like "find class", "search for symbol", etc.
|
||
|
||
### vex
|
||
|
||
Fast hybrid code search — combines tree-sitter AST parsing, FST symbol lookup, BM25 body search, and optional ONNX semantic embeddings. Ships as a CLI (`vex search`, `vex usages`, `vex callers`, `vex similar`, `vex duplicates`, `vex pattern`, etc.) plus an optional MCP server (`vex-mcp`) that exposes the same operations to Claude Code as ~17 structured tools. Useful as a peer or replacement for AST Index when you want semantic / concept-level search in addition to exact symbol lookup.
|
||
|
||
- **Repository:** <https://github.com/tenatarika/vex>
|
||
- **Languages:** 18+ via tree-sitter — Python, TypeScript/JavaScript, Go, Rust, Java, Kotlin, C#, Ruby, Swift, C++, PHP, Bash, Lua, CSS, HTML, YAML, TOML, SQL, Markdown.
|
||
|
||
- **Install (Linux/macOS):**
|
||
|
||
```bash
|
||
brew tap tenatarika/tap && brew install vex
|
||
```
|
||
|
||
Latest release also ships prebuilt tarballs for `linux-x86_64` and `darwin-aarch64`.
|
||
|
||
- **Install (Windows — build from source, ~3 min):**
|
||
|
||
As of v1.5.0 there is **no prebuilt Windows binary** in the release assets, so a Rust toolchain (≥1.80) is required:
|
||
|
||
```bash
|
||
git clone https://github.com/tenatarika/vex.git "$HOME/Documents/vex"
|
||
cd "$HOME/Documents/vex"
|
||
cargo build --release --workspace
|
||
cp target/release/vex.exe target/release/vex-mcp.exe "$HOME/.cargo/bin/"
|
||
```
|
||
|
||
`~/.cargo/bin/` (i.e. `%USERPROFILE%\.cargo\bin`) is already on PATH on any system with `cargo` installed, so both binaries become globally callable immediately.
|
||
|
||
- **Per-project bootstrap:**
|
||
|
||
```bash
|
||
cd <your-project>
|
||
vex init # creates .vex.toml
|
||
vex index --path . # plain index, sub-second, no downloads
|
||
# or, for semantic / concept-level search:
|
||
vex index --path . --semantic # downloads ~86 MB ONNX model on first run
|
||
```
|
||
|
||
Recommended `.vex.toml` for serious use:
|
||
|
||
```toml
|
||
semantic = true # enable meaning-based search (vex similar, vex duplicates, --semantic queries)
|
||
auto_update = true # incrementally refresh the index before each search
|
||
```
|
||
|
||
- **Register `vex-mcp` with Claude Code (user scope — available across all projects):**
|
||
|
||
```bash
|
||
# Windows
|
||
claude mcp add vex -s user -- "$HOME/.cargo/bin/vex-mcp.exe"
|
||
|
||
# macOS / Linux
|
||
claude mcp add vex -s user -- "$HOME/.cargo/bin/vex-mcp"
|
||
```
|
||
|
||
`vex-mcp` defaults `VEX_ROOT` to the current working directory, so a single global registration works for every project — individual tool calls can also override per-call via a `project_root` argument.
|
||
|
||
- **Key commands / MCP tools:** `search` (symbol + semantic), `show` (full body), `usages`, `callers`, `callees`, `implementations`, `outline`, `pattern` (ast-grep–style structural match), `similar` (semantic, requires `--semantic` index), `duplicates`, `status`, `grep` (regex fallback, no index needed), `update` (incremental reindex).
|
||
|
||
### Packaged Skills
|
||
|
||
Packaged `.skill` files available in the [skills/](skills/) directory:
|
||
|
||
- **dolgolyov-dev-facts** — Sync local project configuration with the central claude-code-facts knowledge base.
|
||
- **dolgolyov-git-release-publisher** — Generate release notes and push release tags for repos hosted on Gitea or GitHub. Runs pre-release checks (tests / lint / typecheck), pre-flight guards (branch, remote sync, duplicate tag, dirty tree), and post-tag CI watch. Supports `RELEASE_NOTES.md` overwrite or `CHANGELOG.md` prepend modes and prerelease versions (`-rc.N`, `-beta.N`, `-alpha.N`).
|
||
- **feature-planner** — Plan and develop complex features using a structured, phase-based workflow with git integration, Markdown plans, review gates, and controlled merging.
|
||
|
||
## Toolkits
|
||
|
||
### Everything Claude Code (ECC)
|
||
|
||
A comprehensive collection of skills, rules, agents, and hooks for Claude Code.
|
||
|
||
- **Repository:** <https://github.com/affaan-m/everything-claude-code>
|
||
- **Setup guide:** [ecc-setup-guide.md](ecc-setup-guide.md)
|