How do I install Constellation?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Constellation need an API key?

The publisher lists these environment variables: CONSTELLATION_ACCESS_KEY.

What transport does Constellation use?

Constellation runs locally over stdio.

When was Constellation last checked?

Last checked 2026-11-08. Code Intelligence Platform for AI Coding Agents

Constellation MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @constellationdev/[email protected]

Credentials from the publisher

CONSTELLATION_ACCESS_KEY — Your Constellation access key

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1CONSTELLATION_ACCESS_KEY=<secret> claude mcp add com.shiftinbits-constellation -- npx -y @constellationdev/mcp@1.3.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.shiftinbits-constellation": {4      "command": "npx",5      "args": [6        "-y",7        "@constellationdev/[email protected]"8      ],9      "env": {10        "CONSTELLATION_ACCESS_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.3.0
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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 and the Privacy Policy.

Support

Documentation: docs.constellationdev.io
Report Issues: GitHub Issues

License

AGPL-3.0 - See LICENSE for details.