Skip to content
MCP server

Vulcanus

Local memory vault for coding agents: layered Markdown, Git history and a validity check

Runs locallyStatus and history
Install
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/vulcanus

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vulcanus": {
      "command": "npx",
      "args": [
        "-y",
        "@sunsato/vulcanus"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vulcanus": {
      "command": "npx",
      "args": [
        "-y",
        "@sunsato/vulcanus"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools