snippet-vault
README.md
# snippet-vault
An MCP server that gives Claude a personal code snippet library. Save snippets during any conversation and retrieve them later — across sessions, projects, and machines.
## What it does
**`save_snippet`** — save any code block with a title, language, and tags
**`search_snippets`** — search by title, language, tag, or content
**`get_snippet`** — retrieve a full snippet by ID
**`list_snippets`** — see all saved snippets
**`delete_snippet`** — remove a snippet by ID
Snippets are stored locally at `~/.snippet-vault/snippets.json` — your data stays on your machine.
## Example prompts
- *"Save this debounce function to my vault with tags: utility, typescript"*
- *"Find my auth middleware snippet"*
- *"Show me all my Python snippets"*
- *"List everything in my vault"*
- *"Delete snippet abc123"*
## Add to Claude Desktop
```json
{
"mcpServers": {
"snippet-vault": {
"command": "npx",
"args": ["-y", "@engineeringmatrixexplorer/snippet-vault"]
}
}
}
```
## Add to Claude Code
```bash
claude mcp add snippet-vault -- npx -y @engineeringmatrixexplorer/snippet-vault
```
## Where snippets are stored
Snippets live at `~/.snippet-vault/snippets.json` on your machine. No cloud, no account, no tracking.
## Requirements
- Node.js 18+
## Part of the MCP Developer Tools Bundle
This server is also available as part of a bundle with [engineering-matrix-explorer](https://github.com/officechbusinessservices-creator/engineering-matrix-explorer) and [stack-advisor](https://github.com/officechbusinessservices-creator/stack-advisor).
## License
MIT
TDQS
A3.8/5.0
Scored across 5 tools
Disambiguation5/5
Each tool targets a distinct operation (create, read, list, search, delete) with no overlap in purpose. An agent can clearly differentiate them.
Naming Consistency4/5
All tools follow a verb_noun pattern. Minor inconsistency: 'list_snippets' uses plural noun while others use singular, but the pattern is clear and predictable.
Tool Count5/5
With 5 tools, the server covers all essential operations for a snippet vault without being excessive or sparse. Each tool contributes meaningfully.
Completeness4/5
The tool surface includes create, read (by ID, list, search), and delete operations. An update operation is missing, but snippets are often immutable, so this is acceptable.