Skip to main content
Glama
CodeGraph Memory MCP Lite

CodeGraph Memory MCP Lite

by StaryMoon

CodeGraph Memory MCP Lite

Local-first MCP-style code memory for research repositories: file search, Python symbols, import graph, and repo context packs.

License: MIT Python SQLite FTS

Image source: public Model Context Protocol homepage screenshot, https://modelcontextprotocol.io/. Used as a visual reference for local code-indexing and agent-tool workflows.

Research codebases are often small enough that a heavyweight code intelligence stack is overkill, but large enough that agents lose track of modules, configs, training scripts, and README claims. This project provides a tiny local codegraph memory layer for AI agents. It indexes a repository, extracts Python classes/functions/imports with the standard ast module, stores file text in SQLite FTS, and exposes MCP-style tools over stdio.

If this helps your agent understand a research repo faster, a star helps other builders discover it.

Features

  • Local-only SQLite database.

  • File full-text search over code, Markdown, configs, and scripts.

  • Python symbol extraction: classes, functions, async functions, and imports.

  • Lightweight import graph and symbol lookup.

  • MCP-style tools:

    • index_codebase

    • search_code_memory

    • find_symbol

    • get_dependency_graph

    • summarize_repo_context

Related MCP server: rag-rat

Quick Start

git clone https://github.com/StaryMoon/codegraph-memory-mcp-lite.git
cd codegraph-memory-mcp-lite
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

codegraph-memory index examples/sample_repo
codegraph-memory symbol Trainer
codegraph-memory graph --limit 20
codegraph-memory context

MCP Config

{
  "mcpServers": {
    "codegraph-memory-lite": {
      "command": "python3",
      "args": ["-m", "codegraph_memory_mcp_lite.server", "serve"],
      "env": {
        "CODEGRAPH_MEMORY_DB": "/absolute/path/to/codegraph-memory.sqlite"
      }
    }
  }
}

Why This Exists

Most code assistants can read files, but they often lack a persistent local map of:

  • where classes and functions are defined;

  • which modules import which modules;

  • what README claims the repo makes;

  • what training/evaluation scripts exist;

  • which files are relevant to a user query.

This project gives an agent a small memory substrate before it starts editing.

License

MIT.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Local-first codebase context engine that parses code into a ranked dependency graph and serves it to AI tools via MCP for deep structural understanding.
      5
      18 npm
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Semantic codebase search + persistent working memory for AI code editors. Local, zero-config, MCP. No API key.
      23
      104 PyPI
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Offline-first, persistent repository memory for coding agents. Provides MCP tools for repository scanning, searching, context, and impact analysis, helping agents navigate and edit code efficiently.
      Apache 2.0