Constellation

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

1. Parse and Analyze: The CLI tool analyzes source code in _your_ environment, extracting structural metadata (functions, classes, variables, imports, calls, references, etc.)
2. Upload: Only the metadata is securely sent to Constellation, never raw source code
3. 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/](https://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.