Codebase Memory MCP Server: Setup for Claude Code, Cursor and Other Apps

• Scans a project folder and builds a searchable map of its code

  Reads the project on your computer and stores a graph of its functions, classes and calls. It can run in the background for large projects, and it keeps the map up to date while your session is open.

  Try: “Index this project.”

  Write · index_repository

• Finds functions, classes and files by name, structure or meaning

  Searches the code map by structure, keywords or meaning, with paging for long result lists.

  Try: “Find the functions that handle user login.”

  Read · search_graph

• Follows who calls what, and where data flows

  Traces callers and callees of a function up to 15 levels deep. Other modes follow data flow, calls between services, and what a deploy job runs.

  Try: “Who calls the function that charges a card?”

  Read · trace_path

• Shows the source of one function

  Returns the source code of a function when you give its full name.

  Try: “Show me the code for the checkout handler.”

  Files · get_code_snippet

• Lists what a file contains, in order

  Lists the functions, classes and other declarations in one file in the order they appear.

  Try: “Give me an outline of src/server.ts.”

  Read · get_file_outline

• Gives a one-page overview of the codebase

  Summarises languages, packages, routes, busy spots and clusters of related code.

  Try: “Give me an architecture overview of this repo.”

  Read · get_architecture

• Shows what kinds of things the code map holds

  Lists node and edge counts, relationship patterns and properties for each label. The README says to run it first.

  Try: “What does the code map for this project contain?”

  Read · get_graph_schema

• Runs a custom read-only query on the code map

  Runs a read-only Cypher-style query for questions the other tools do not cover.

  Try: “Query the graph for functions with more than 20 callers.”

  Read · query_graph

• Searches the text of indexed files, like grep

  Greps the indexed project files for text.

  Try: “Search the project for every use of API_BASE_URL.”

  Files · search_code

• Shows what your uncommitted changes could break

  Maps your git diff to the functions it touches and rates the risk of each change.

  Try: “What could my current changes break?”

  Files · detect_changes

• Compares two snapshots of the code map

  Reports which nodes and edges were added or removed between a base and a target snapshot.

  Try: “Compare the graph before and after this refactor.”

  Read · compare_graphs

• Lists the projects that are indexed

  Lists indexed projects with paging. With detail set to stats it adds node and edge counts and database sizes.

  Try: “Which projects are indexed?”

  Read · list_projects

• Checks whether a project is indexed and up to date

  Reports the indexing status of one project.

  Try: “Is this project fully indexed?”

  Read · index_status

• Checks that given files are in the index and fresh

  Checks whether exact paths or a scope are indexed and fresh. A clean result means no recorded gap, not proof of completeness.

  Try: “Are the files under src/api indexed?”

  Read · check_index_coverage

• Reads or edits the project's architecture decision record

  Reads, replaces or edits sections of the Architecture Decision Record stored with the project index.

  Try: “Add a section to the ADR about why we chose Postgres.”

  Write · manage_adr

• Saves observed call paths into the code map

  Stores call paths you observed, such as from a runtime trace, under a run label. Names that do not match an indexed symbol are reported back.

  Try: “Record this observed call path under run label staging-1.”

  Write · ingest_traces

• Deletes a project's code map

  Removes a project and all its graph data, including its decision record file. It does not touch your source files.

  Try: “Delete the index for the old-api project.”

  Delete · delete_project

Watch out for

• It reads your whole project and stores a copy of its structure

  The index holds function names, call links and code facts for every project you index. Index only repositories you are happy to keep on disk, and delete the project index when you are done. github.com

• It can delete project indexes and rewrite decision records

  delete_project removes a project's graph data and manage_adr can replace the decision record. Your source files are not touched. Use the read-only profile if the agent should only look. github.com

• The installer script changes your agent settings

  The recommended installer adds skills, agent profiles and hooks to detected clients. Use the skip-config option or the manual config if you want only the server. github.com

• Windows Defender may flag the binary

  The README says a false positive is known and links its evidence. Check the release checksums before you run it. github.com

Security advisories