mache

Mache

Mache turns code and structured data into a navigable graph — functions, types, cross-references, and call chains — exposed as MCP tools or a mounted filesystem.

Point it at a codebase. It parses the code, discovers the structure, and lets your agent (or you) explore by following call chains, jumping to definitions, and reading context — instead of grepping through flat files.

Mache (/mɑʃe/ mah-shay): from papier-mâché — raw material, crushed and remolded into shape.

Quick start

Install

Build from source (requires Go 1.23+ and Task):

git clone https://github.com/agentic-research/mache.git
cd mache
task build
task install   # copies to ~/.local/bin

macOS: brew install go-task for Task. Linux: Install Task. NFS mount requires nfs-common (apt-get install nfs-common).

Use with Claude Code

Start the server, then register it:

mache serve .                    # starts on localhost:7532
claude mcp add --transport http mache http://localhost:7532/mcp

Mache auto-infers the schema from your codebase. One server shared across all sessions.

MCP tools

12 tools work out of the box. 3 optional tools provide LSP type info and semantic search when ley-line-open enrichment is available — without it, they return a message explaining how to enable them.

How it works

1. Parse — tree-sitter parses source into AST nodes (28 languages)
2. Infer — schema inference (FCA) discovers the natural groupings (functions/, types/, classes/)
3. Link — cross-reference extraction builds a call graph from identifiers and imports
4. Project — the graph is exposed as MCP tools (primary) or a mounted filesystem (optional)

Mount as a filesystem (optional)

The graph can also be browsed as a mounted directory tree — useful for ls, cat, shell scripts, or tools that work with files:

mache --infer -d ./src --writable /tmp/mache-src

/tmp/mache-src/
  functions/
    HandleRequest/
      source        # the function body
      context       # imports, types visible to this scope
      callers/      # who calls this function
      callees/      # what this function calls
    ValidateToken/
      source
  types/
    Config/
      source        # type Config struct { ... }
  _project_files/
    README.md
    go.mod

Navigate by function name, not file path. callers/ and callees/ are virtual directories that appear only when references exist.

# Mount with agent mode (generates PROMPT.txt for LLMs)
mache --agent -d ~/my-project

# Mount a SQLite database (zero-copy)
mache --schema examples/nvd-schema.json --data results.db /tmp/nvd

MCP server options

# HTTP (recommended) — one server, multiple clients
mache serve .
mache serve --http localhost:9000 -s examples/nvd-schema.json results.db

# stdio — for tools that manage the subprocess lifecycle
mache serve --stdio .

mache serve /path/to/data &
claude mcp add --transport http mache http://localhost:7532/mcp

{
  "mcpServers": {
    "mache": {
      "command": "mache",
      "args": ["serve", "--stdio", "."]
    }
  }
}

{
  "mcpServers": {
    "mache": {
      "command": "/path/to/mache",
      "args": ["serve", "--stdio", "/path/to/code"]
    }
  }
}

Status

Docs

• Architecture
• Prior Art & Landscape
• Example Schemas
• ADRs
• Contributing

License

Apache 2.0