com.shiftinbits/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/

• 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.