codesight MCP Server: Setup for Claude, Cursor and Other Apps

• Maps the whole project

  Scans a project folder and returns one context map with routes, database models, components, libraries, config, middleware and the dependency graph. It is the largest answer of the set, so use it once at the start. The first call of a session also writes the context map as .codesight/*.md files in the project.

  Try: “Scan this project and tell me how it is laid out.”

  Write · codesight_scan

• Gives a short project overview

  Returns a compact overview of the project in about 500 tokens, a cheaper first look than a full scan.

  Try: “Give me a short summary of this codebase.”

  Write · codesight_get_summary

• Lists API routes

  Returns the routes found in the project. You can filter by path prefix, tag such as auth or payment, or HTTP method.

  Try: “List all POST routes under /api/users.”

  Write · codesight_get_routes

• Lists database models

  Returns models with fields, types, constraints and relations. You can filter by model name.

  Try: “Show the User and Order models with their relations.”

  Write · codesight_get_schema

• Shows what a change would affect

  Takes one or more files and returns all files, routes, models and middleware that depend on them, down to a depth you set. Use it before an edit.

  Try: “What breaks if I change src/lib/auth.ts?”

  Write · codesight_get_blast_radius

• Lists environment variables used in code

  Returns env vars found across the code with whether each is required, its default and the file that reads it.

  Try: “Which env vars are required to run this app?”

  Write · codesight_get_env

• Finds the most imported files

  Returns the files imported most often, which have the biggest blast radius. You can set how many to return.

  Try: “Which 10 files are imported the most?”

  Write · codesight_get_hot_files

• Forces a fresh scan

  Re-scans the project so later answers reflect your latest changes. Call it after big edits.

  Try: “Refresh the project map, I just refactored the API.”

  Write · codesight_refresh

• Lists the generated wiki articles

  Returns the wiki catalog with a one-line summary per article. It needs the wiki generated first with npx codesight --wiki.

  Try: “What wiki articles exist for this project?”

  Write · codesight_get_wiki_index

• Reads one wiki article

  Returns one subsystem article such as auth, database or payments, written in plain narrative form.

  Try: “Read the auth wiki article and explain login.”

  Write · codesight_get_wiki_article

• Checks the wiki for gaps

  Finds orphan articles, missing cross-links and articles that may be stale.

  Try: “Lint the wiki and list what needs fixing.”

  Write · codesight_lint_wiki

• Lists background events and queues

  Returns queues, Kafka topics, Redis channels and event emitters found in the code. You can filter by system such as bullmq or celery.

  Try: “What background jobs does this app run?”

  Write · codesight_get_events

• Shows which routes and models have tests

  Returns a coverage summary of routes and models that have matching test files, and lists the uncovered endpoints.

  Try: “Which endpoints have no tests?”

  Write · codesight_get_coverage

• Reads a notes folder map

  Returns decisions, open questions, themes, people and a note index for a docs or notes folder. It needs npx codesight --mode knowledge run first.

  Try: “What decisions are recorded in my notes?”

  Read · codesight_get_knowledge

Watch out for

• It writes a .codesight folder into the project it scans

  Almost every tool scans the project first, and each scan writes routes.md, schema.md and other map files into .codesight/ inside that folder (or the folder you pass as directory). The server does not delete anything. Add .codesight/ to .gitignore, or commit it on purpose. github.com

• It reads your whole project folder

  Scans include routes, schemas and env variable names, so the output can show how your system is built. Point it only at projects you are happy to share with your assistant. github.com

• Some tools need setup commands run first

  The wiki and knowledge tools return nothing useful until you run npx codesight --wiki or npx codesight --mode knowledge. Those commands generate the wiki and knowledge files; the MCP server only reads them. github.com

Security advisories