mcpField
C
Constellation

Constellation

Local
github.com/ShiftinBitsDeveloper Tools3Updated 4d ago
Repository

About Constellation

Constellation is a code-intelligence MCP server for AI coding assistants, providing code structure and relationship data without sending source code. Its local CLI analyzes code and sends metadata for assistants to query.

Key features

  1. 01Analyze functions, classes, imports, and references
  2. 02Build code intelligence from structural metadata
  3. 03Keep raw source code in the local environment
  4. 04Maintain separate intelligence per Git branch
  5. 05Require API keys for requests

Use cases

  1. 01Ask an AI coding assistant about code relationships
  2. 02Navigate a codebase using structural context
  3. 03Query branch-specific code intelligence

MCP support

The MCP server exposes tools for AI assistants to query Constellation’s code knowledge graph; the local CLI analyzes code and uploads metadata rather than source code.

#code#context#codegraph#navigation#intelligence#constellation#shiftinbits

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "constellation": {
      "command": "npx",
      "args": [
        "-y",
        "@constellationdev/mcp"
      ],
      "env": {
        "CONSTELLATION_ACCESS_KEY": "<CONSTELLATION_ACCESS_KEY>"
      }
    }
  }
}
Run commandnpx -y @constellationdev/mcp
Environment variables to set
CONSTELLATION_ACCESS_KEYSecretYour Constellation access key

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@constellationdev/mcp1.3.0

Tools

1

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
codestringYesJavaScript code to execute. Can use top-level await. Available API methods: searchSymbols, getSymbolDetails, getDependencies, getDependents, findCircularDependencies, traceSymbolUsage, getCallGraph, impactAnalysis, findOrphanedCode, getArchitectureOverview
cwdstringYesAbsolute path to the project directory being queried. Used to locate the correct constellation.json by finding the git repository root. Set this to the root of the repository or workspace folder you are working in.
timeoutnumberNoMaximum execution time in milliseconds (default: 30000, max: 60000)

Details

From the project README

Constellation MCP Server

NPM Version TypeScript v5.9+ Node.js v24+ MCP Badge License: AGPL-3.0 Snyk Monitored

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/

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

License

AGPL-3.0 - See LICENSE for details.

Copyright © 2026 ShiftinBits Inc.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.