Vulcanus
Local memory vault for coding agents: layered Markdown, Git history and a validity check
- Pricing
- Free
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.6.3
- Listing updated
- 2 days ago
About Vulcanus
Vulcanus is a free MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Vulcanus generates a Git-versioned vault of linked Markdown that Claude Code, Cursor, Codex and other agents can recall project by project. After a few setup questions it writes a routing layer, an operator profile, an agent protocol and a cluster per project, then validates that every link resolves and every project is reachable. If you already keep an Obsidian vault, it adds the structure there.
The design aims at token economy. An agent reads a Recall Map, then one project's Capsule, and opens Context, Decisions or Rules only when needed. The README reports that a task-scoped recall read 59 percent less than the whole vault on its demo, and the vulcanus stats command measures this on your own vault. Unconfirmed facts go under Needs Confirmation, and a changed decision names what it replaced.
It can seed the vault from history in ChatGPT exports, Claude data and Claude Code, Codex, Cursor and Gemini CLI sessions, read locally, with only the projects you tick becoming notes. Vault text can be in English, Turkish, German or Spanish. It needs Node 22.12 or newer, runs locally with no account, and must be installed globally so agents can reach the vulcanus command.
Install
Run in a terminal
claude mcp add vulcanus -- npx -y @sunsato/vulcanusAdd to claude_desktop_config.json
{
"mcpServers": {
"vulcanus": {
"command": "npx",
"args": [
"-y",
"@sunsato/vulcanus"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"vulcanus": {
"command": "npx",
"args": [
"-y",
"@sunsato/vulcanus"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"vulcanus": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sunsato/vulcanus"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"vulcanus": {
"command": "npx",
"args": [
"-y",
"@sunsato/vulcanus"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"vulcanus": {
"command": "npx",
"args": [
"-y",
"@sunsato/vulcanus"
]
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- recall
- Recall a project from the vault.
What it does
- Layered recall
- Recall Map, Capsule, then deeper notes opened only when needed.
- Validated graph
- The doctor command checks links and project reachability.
- Git history
- Every change is a commit, and replaced decisions are marked.
- History import
- Seeds notes from ChatGPT, Claude and coding-agent session history.
- Explicit uncertainty
- Unconfirmed items live under Needs Confirmation.
- Four vault languages
- English, Turkish, German or Spanish content.
Good for
- Stop re-explaining architecture to a coding agent
- Keep decisions and rules where agents recall them
- Turn old chat history into project notes
- Add agent memory to an existing Obsidian vault
Pricing
Free
Free; runs locally, no account
Prices change. Check vulcanus.sunsato.com before you buy.
Vulcanus FAQ
Does it need an account?
No. It runs locally, with only an optional once-a-day version check.
What do I need?
Node 22.12 or newer and a global npm install of @sunsato/vulcanus.
How do I connect it to Claude Code?
Run claude mcp add vulcanus -- vulcanus serve.
Can it use my chat history?
Yes, it can read exports and local sessions from several tools, and only the names you tick become notes.
Is Vulcanus free?
Yes. Vulcanus is free to use.
How do I add Vulcanus to Claude Code?
Run this command in your terminal: claude mcp add vulcanus -- npx -y @sunsato/vulcanus
What are the best alternatives to Vulcanus?
The closest alternatives to Vulcanus are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Vulcanus

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools