Provides AI coding assistants with intelligent access to codebase structure, dependencies, and relationships using metadata-based knowledge graphs.
Also known as ShiftinBits/constellation-mcp, constellation-mcp, @constellationdev/mcp
- Stars
- 3
- Tools
- —
- Downloads, 30 days
- 1,009
- Latest version
- 1.3.0
- Last commit
- Oct 27, 2026
- License
- AGPL-3.0
What is Constellation MCP?
Constellation provides AI coding assistants with intelligent access to codebase structure, dependencies, and relationships using metadata-based knowledge graphs.
Summary generated from the project's README
About Constellation MCP server
Constellation provides AI coding assistants with intelligent access to codebase structures, dependencies, and relationships. It functions by using a metadata-based knowledge graph to give tools insight into functions, classes, variables, and imports. This approach allows an AI to understand complex code relationships without the need to transmit any raw source code to the cloud.
Developers set up the server using a stdio connection via npx. The configuration requires a CONSTELLATION_ACCESS_KEY environment variable for authentication. While it can be added to project-level or system-level configurations for tools like Claude Code or Cursor, the developers suggest using official Constellation Plugins for the best performance.
The system works through a three-step process where a local CLI tool parses the source code to extract structural metadata. This metadata is uploaded to the Constellation Service, which stores it in a knowledge graph. AI assistants then use the MCP server to send queries to the API and receive rapid answers based on that graph.
What you can do with it
- 1Analyze codebase relationshipsAsk the AI to identify how different functions and classes interact across the entire project.
- 2Maintain privacy during analysisPerform deep code intelligence tasks without sending your actual source code to a remote server.
Written from the project's README. Every use case is checked against a quote from it.
How to install Constellation MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Constellation MCP in Claude Code
$ claude mcp add --env 'CONSTELLATION_ACCESS_KEY=<YOUR_CONSTELLATION_ACCESS_KEY>' constellation-mcp -- npx -y @constellationdev/mcpInstall Constellation MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"constellation-mcp": {
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "<YOUR_CONSTELLATION_ACCESS_KEY>"
}
}
}
}Install Constellation MCP in VS Code
.vscode/mcp.json
{
"servers": {
"constellation-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "<YOUR_CONSTELLATION_ACCESS_KEY>"
}
}
}
}Install Constellation MCP in VS Code CLI
$ code --add-mcp '{"name":"constellation-mcp","type":"stdio","command":"npx","args":["-y","@constellationdev/mcp"],"env":{"CONSTELLATION_ACCESS_KEY":"<YOUR_CONSTELLATION_ACCESS_KEY>"}}'Install Constellation MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"constellation-mcp": {
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "<YOUR_CONSTELLATION_ACCESS_KEY>"
}
}
}
}Install Constellation MCP in Codex
$ codex mcp add constellation-mcp --env 'CONSTELLATION_ACCESS_KEY=<YOUR_CONSTELLATION_ACCESS_KEY>' -- npx -y @constellationdev/mcpInstall Constellation MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.constellation-mcp] command = "npx" args = ["-y", "@constellationdev/mcp"] [mcp_servers.constellation-mcp.env] CONSTELLATION_ACCESS_KEY = "<YOUR_CONSTELLATION_ACCESS_KEY>"
Install Constellation MCP in Gemini CLI
$ gemini mcp add -s user -e 'CONSTELLATION_ACCESS_KEY=<YOUR_CONSTELLATION_ACCESS_KEY>' constellation-mcp npx -- -y @constellationdev/mcpInstall Constellation MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"constellation-mcp": {
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "<YOUR_CONSTELLATION_ACCESS_KEY>"
}
}
}
}Configuration
CONSTELLATION_ACCESS_KEYRequiredSecretYour Constellation access key
| Name | Description | |
|---|---|---|
| CONSTELLATION_ACCESS_KEY | Your Constellation access key | RequiredSecret |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableshiftinbits/constellation-mcp is public and reachablegithub.com/shiftinbits/constellation-mcp ↗Pass
- Package names this repository as its source@constellationdev/mcp names shiftinbits/constellation-mcp as sourcenpmjs.com/package/@constellationdev/mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @constellationdev/mcpnpmjs.com/package/@constellationdev/mcp/v/1.3.0#provenance ↗Pass
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-27github.com/shiftinbits/constellation-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @constellationdev/mcpPass
- No critical advisory in the package or its dependencies7 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubConstellation 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.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 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 and the Privacy Policy.
Support
- Documentation: docs.constellationdev.io
- Report Issues: GitHub Issues
License
AGPL-3.0 - See LICENSE for details.
Copyright © 2026 ShiftinBits Inc.
Constellation MCP questions
How do I add Constellation MCP to Claude Code?
Run claude mcp add --env 'CONSTELLATION_ACCESS_KEY=<YOUR_CONSTELLATION_ACCESS_KEY>' constellation-mcp -- npx -y @constellationdev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Constellation MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does Constellation transmit my source code?
No, the service only transmits structural metadata and relationships, never the raw source code.
How do I install the Constellation MCP server?
You can add it to your AI assistant's configuration using npx to run @constellationdev/mcp@latest with a CONSTELLATION_ACCESS_KEY environment variable.
How does the code analysis process work?
A CLI tool analyzes the source code in your environment to extract structural metadata like functions, classes, and imports, which is then uploaded to a knowledge graph.