Skip to main content

Module mcp

Module mcp 

Source
Expand description

Comindly MCP server — the code graph as tools a coding agent calls live.

Loads the resolved org graph from LanceDB once at startup (local mmap or S3), holds it in memory, and serves deterministic navigation over stdio:

  • search — natural-language / hybrid code search (semantic + lexical + centrality)
  • repos — indexed repositories + symbol counts
  • suggest — pre-generated questions you can ask (query catalog)
  • find — locate symbols by name/path substring
  • zoom — 360° view of a symbol (callers, callees, importers, members)
  • ripple — org-wide blast radius (who breaks if I change this)
  • thread — forward call trace from an entry point
  • flow — pre-generated walkthrough of a flow + its live call trace
  • context_pack — the minimal token-budgeted read-set to change a symbol safely
  • guide — the repo’s inferred style guide

Results are handed back as markdown by default (readable for the agent). Pass serve --format json for JSON text with the same JSON as structured content. Every result carries an exact file:line.

Structs§

ComindlyServer

Functions§

http
MCP over streamable HTTP for hosts (the server’s own names), answering from current.
load
Load the graph, enrichment, conventions and search model for uri into a server.
serve_stdio
Load the graph (and any LLM enrichment) from uri and serve MCP over stdio until the client disconnects. markdown controls whether tool results are handed back as markdown text (default) or raw JSON.
tools
The MCP tools this server offers: (name, description).

Type Aliases§

Shared
The server agents reach over HTTP; empty until an index exists, replaced after each re-index.
Teams
The org’s teams, shared with the web app so changes reach agents at once.