Constellation
The Constellation MCP server provides graph-backed code intelligence for AI coding assistants, enabling deep structural analysis of a codebase without transmitting source code (only metadata is sent, never raw source).
Core capabilities:
Search & inspect symbols — Find definitions of functions, classes, and variables (
searchSymbols,getSymbolDetails)Analyze dependencies — Discover what a file depends on (
getDependencies) and what depends on it (getDependents)Trace symbol usage — Track all usages of a symbol across the codebase (
traceSymbolUsage)Explore call graphs — Map how a symbol is invoked (
getCallGraph)Impact analysis — Assess blast radius and breaking-change risk before modifying code (
impactAnalysis)Detect circular dependencies — Find circular dependency chains (
findCircularDependencies)Find orphaned/dead code — Identify unused exports or unreferenced code (
findOrphanedCode)Architecture overview — Get a high-level structural view of a codebase (
getArchitectureOverview)Compose complex queries — Execute arbitrary JavaScript with top-level await and run parallel API calls
Browse the API — List available methods and TypeScript type definitions via
api.listMethods()andapi.help()
Additional features:
Multi-language support: TypeScript, JavaScript, Python, and more (check via
api.getCapabilities())Branch-aware indexing scoped to the current git branch
Access control enforced via API keys
Designed for structural questions (definitions, callers, impact) — use Grep/Read for text search instead
Integrates with Git to provide branch-aware code intelligence, ensuring that codebase metadata and analysis remain discrete and isolated between different development branches.
Provides GitHub Copilot with structured codebase metadata and relationship analysis, enabling deeper context for code intelligence and assistant-led development.
Constellation MCP Server
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.
Quick Start
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}"
}
}
}
}
The above example is a generic format for the .mcp.json file used by some tools such as VSCode and Claude Code.
Rather than directly configuring the MCP server, it is recommended to install and utilize official Constellation Plugins for optimal performance and behavior!
For information on configuring other AI assistants see the MCP Server > Installation doc.
For further instructions regarding authentication, project setup, and configuration refer to the official docs.
How It Works
%%{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:#4A90E2Parse and Analyze: The CLI tool analyzes source code in your environment, 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
Documentation
Find the full and comprehensive documentation at docs.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
Privacy & Security
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 the official Privacy & Security documentation.
Support
Documentation: docs.constellationdev.io
Report Issues: GitHub Issues
License
AGPL-3.0 - See LICENSE for details.
Copyright © 2026 ShiftinBits Inc.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ShiftinBits/constellation-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server