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}"
}
}
}
}
NOTE
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:#4A90E2
- Parse 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.