Constellation
About
Your AI agents don't understand your codebase. Upgrade from text search to code understanding.
Details
- Author
- ShiftinBits
- Downloads
- 456
- Categories
- Developer Tools, AI, Other
Jump to
- Turns codebase into a semantic graph, not a grep loop
- Single code_intel tool with JavaScript API
- Multi-language: TypeScript, JavaScript, Python (more coming)
- Multi-project support with per‑project git root resolution
- Fast: parallel API calls, inline source snippets
- Safe: hardened sandbox with isolated child process and memory limits
- Privacy by design: source code never leaves your machine
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ConstellationCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Invoke the code_intel tool with JavaScript API calls such as api.searchSymbols, api.impactAnalysis, and api.getDependents. The tool composes queries like code, allowing the assistant to ask about symbol definitions, usage, impact, and dependencies.
code_intel
DECISION RULE: Structure questions → this tool. Text search → Grep. Before using Grep, ask: Is this a STRUCTURE question (definitions, callers, impact) or a TEXT question (strings, config)? QUICK START: `return await api.searchSymbols({query: "AuthService"})` — simple queries are one-liners. Run `api.listMethods()` for full API reference with signatures and descriptions. Run `api.help("methodName")` for inline TypeScript type definitions — no resource reads needed. Compose: `const [impact, deps] = await Promise.all([api.impactAnalysis({symbolId}), api.getDependents({filePath})]);` WHY THIS TOOL: Graph-backed intelligence finds indirect relationships, transitive dependencies, and breaking change risks that text search cannot detect. "What uses X?" disambiguation: getDependents (file imports) vs getCallGraph (call chain) vs traceSymbolUsage (all usages). USE IMMEDIATELY WHEN: • BEFORE using Edit on a function/class → run impactAnalysis({symbolId}) first • BEFORE exploring an unfamiliar codebase → run getArchitectureOverview() • BEFORE refactoring → trace getDependencies + getDependents for blast radius • Running 3+ Grep calls for structure? STOP → use code_intel instead TOP 5 QUESTIONS (query is case-insensitive substring match): • "Where is X defined?" / "Find function Y" → searchSymbols({query}) • "What calls X?" / "What imports this?" → getDependents({filePath}) or getCallGraph({symbolId}) • "What does X depend on?" → getDependencies({filePath}) • "Safe to modify X?" / "Blast radius?" → impactAnalysis({symbolId}) • "Find dead code" / "Unused exports?" → findOrphanedCode() • "Complex functions?" / "Refactoring targets?" → searchSymbols results include complexity.cyclomaticComplexity + complexityRisk per function NOT FOR: literal string search, log messages, config values, or reading source code. Use Grep/Glob/Read for those. Supports TypeScript, JavaScript, Python, and more — run api.getCapabilities() to check your project. WRONG TOOL SIGNAL: If you've run 3+ Grep calls for structure (callers, dependencies, impact), STOP and use code_intel instead. Typical workflow: code_intel to find (results include source snippets) → Edit to modify IMPORTANT: The `cwd` parameter is required — always set it to the target project directory path.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"constellation": {
"constellation": {
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp@latest"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "${CONSTELLATION_ACCESS_KEY}"
}
}
}
}
}McpServers
{
"constellation": {
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp@latest"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "${CONSTELLATION_ACCESS_KEY}"
}
}
}Give your AI coding assistant instant, intelligent access to your entire codebase's structure, dependencies, and relationships without transmitting any source code. Constellation provides code intelligence as a service to AI coding assistant tools.
Add the Constellation MCP server to your AI assistant project-level config (or system-level if your tooling doesn't support project-level configuration):
{ "mcpServers": { "constellation": { "type": "stdio", "command": "npx", "args": ["-y", "@constellationdev/mcp@latest"], "env": { "CONSTELLATION_ACCESS_KEY": "${CONSTELLATION_ACCESS_KEY}" } } } }
[!NOTE]
The above example is a generic format for the.mcp.jsonfile used by some tools such as VSCode and Claude Code.
Rather than directly configuring the MCP server, it is recommended to install and utilize officialConstellation Pluginsfor optimal performance and behavior!
For information on configuring other AI assistants see theMCP Server > Installation doc.
For further instructions regarding authentication, project setup, and configuration refer to theofficial docs.
%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#4A90E2', 'primaryTextColor': '#EEEEEE', 'primaryBorderColor': '#2B2C34', 'lineColor': '#4A90E2', 'secondaryColor': '#1F1F28', 'tertiaryColor': '#0B0C10', 'edgeLabelBackground': '#1F1F28' }}}%% flowchart LR subgraph local["💻 Your Environment"] direction TB code["📂 Source Code"] cli["⚙️ Constellation CLI"] ai["🤖 AI Coding Assistant"] mcp["🧩 Constellation MCP"] code --> cli end subgraph cloud["✨ Constellation Service"] direction TB api["🔌 API"] graphdb[("🧠 Knowledge Graph")] api <--> graphdb end cli a1@-->|"Metadata Upload"| api ai <-->|"Tool Calls"| mcp mcp a2@<-->|"Queries"| api a1@{ animation: fast } a2@{ animation: fast } style local fill:#1F1F28 style cloud fill:#1F1F28,stroke:#4A90E2 style cli stroke:#4A90E2 style mcp stroke:#4A90E2 style api stroke:#4A90E2 style graphdb stroke:#4A90E2
- Parse and Analyze: The CLI tool analyzes source code inyourenvironment, extracting structural metadata (functions, classes, variables, imports, calls, references, etc.)
- Upload: Only the metadata is securely sent to Constellation, never raw source code
- Query: AI assistants use the Constellation MCP tool to send complex queries, and get rapid answers derived from the knowledge graph
Find the full and comprehensive documentation atdocs.constellationdev.io/mcp/
- Installation & Setup- Configure for Claude Code, Cursor, GitHub Copilot, and more
- Tools Reference- Code Mode API and available methods
- Troubleshooting- Common issues and solutions
- No source code transmission- Only metadata and relationships
- Access control- API keys required for all requests
- Branch isolation- Each git branch maintains discrete code intelligence
For comprehensive information regarding privacy and security, see theofficial Privacy & Security documentation.
- Documentation:docs.constellationdev.io
- Report Issues:GitHub Issues
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
Instead of direct calling MCP tools, mcpcode server transforms MCP tool calls into TypeScript programs, enabling smarter, lower-latency orchestration by LLMs.
Supercharge your Agent with Semantic Code Intelligence and save 💰 in the process!
AI-to-AI code review platform — Claude, Codex, and Gemini cross-check each other via MCP, REST API, and CLI for consensus-based results.
A code sandbox for AI assistants to safely execute arbitrary code. Requires a 302AI API key for authentication.
Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.
MCP server to dynamically load Claude Code skills into AI agents
MCP bridge that lets Claude Code delegate heavy tasks to the Antigravity CLI (agy) — purpose-built tools, model routing with fallback, session continuity, and output truncation to save Claude's context and tokens.
Exposes local execution of Aider commands as a detached process using MCP.
An MCP server for offloading AI coding tasks to Aider, enhancing development efficiency and flexibility.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
