sirius-mcp

MCP server that connects Claude to the Sirius index server and local repo-agent snippets.

Install from npm with:

npm install -g sirius-mcp

Point Claude at sirius-mcp after configuring the Sirius index URL, repo-agent URL, and token environment variables described in the root README. The package also keeps a sirius-mcp-proxy binary alias for existing configs.

Use index_repo from Claude/MCP to register a local repo path with the always-on repo-agent and start indexing. Use list_local_repos to inspect repos known to the local agent. After that, semantic_code_search, hybrid_search, symbol_search, get_call_chain, impact_analysis, ripgrep_search, sync_repo, and sync_status operate through the repo-agent and index server. Pass reset=true to index_repo or sync_repo when you need to purge and rebuild a polluted index.

Snippet enrichment is bounded by SIRIUS_MCP_ENRICH_CONCURRENCY, which defaults to 16 and caps at 50, matching the MCP tool top_k limit. Normal top_k <= 16 searches fetch snippets in one wave; larger windows avoid unbounded local file-range fan-out.

semantic_code_search, hybrid_search, symbol_search, get_call_chain, and impact_analysis compare indexed file hashes with local snippet hashes when include_code=true. With auto_sync_stale=true, stale snippets trigger one local repo-agent sync and then rerun the lookup.

get_call_chain forwards max_edges, defaulting to 300, and includes edge_summary when dense graph neighborhoods omit edges. It also forwards max_unresolved, defaulting to 200; set it to 0 for compact graph-only responses when unresolved callees are not needed. max_code_nodes defaults to 50, so large graph and impact-analysis responses keep all node metadata but only enrich the first N nodes with local source snippets.

The package is published publicly on npm as sirius-mcp.