MCP Server

The Constellation MCP Server connects your AI coding assistants to Constellation's powerful codebase intelligence system. Configure the Constellation MCP server for your project

Installation

TIPS: Automatic Setup and Configuration

It is strongly recommended to use the Constellation CLI command constellation init to automatically configure your AI coding tools in your project, and to commit those configurations to your project's source control repository (for AI assistants that support project-level configuration).
The CLI utility also configures custom hooks for supported AI tools, which further optimizes LLM organic utilization of Constellation tools.
If using plugins, such as our 🧩 Claude Code Plugin or 🧩 OpenCode Plugin, you do not need to add the Constellation MCP server configuration independently as it comes bundled with the plugins.

Manually configure the Constellation MCP server by following the directions below for your preferred AI tools.

Claude Code

📚 Official Documentation 🔗

Use the official Constellation Plugin for Claude Code. Add the following properties to the root of the .claude/settings.json file in your project:

"extraKnownMarketplaces": {
   "constellation-marketplace": {
      "source": {
         "source": "github",
         "repo": "ShiftinBits/constellation-claude"
      }
   }
},
"enabledPlugins": {
   "constellation@constellation-marketplace": true
}

Codex

📚 Official Documentation 🔗

Add the following section to the Codex .codex/config.toml file in your project:

[mcp_servers.constellation]
command = "npx"
args = ["-y", "@constellationdev/mcp@latest"]
env_vars = ["CONSTELLATION_ACCESS_KEY"]
enabled_tools = ["code_intel"]

Copilot CLI

📚 Official Documentation 🔗

Add the following property to the mcpServers object of the ~/.copilot/mcp_settings.json file in your system user folder:

"constellation": {
   "type": "local",
   "command": "npx",
   "args": [
      "-y",
      "@constellationdev/mcp@latest"
   ],
   "tools": ["code_intel"],
   "env": {
      "CONSTELLATION_ACCESS_KEY": "${CONSTELLATION_ACCESS_KEY}"
   }
}

Cursor

📚 Official Documentation 🔗

There are multiple alternatives for configuring MCP servers in your project for use with Cursor.

Recommended: Click the following button to automatically install the Constellation MCP server with Cursor:

Add the following property to the mcpServers object of the mcp.json file:

"constellation": {
   "type": "stdio",
   "command": "npx",
   "args": [
      "-y",
      "@constellationdev/mcp@latest"
   ],
   "env": {
      "CONSTELLATION_ACCESS_KEY": "${env:CONSTELLATION_ACCESS_KEY}",
   }
}

Gemini CLI

📚 Official Documentation 🔗

Add the following property to the mcpServers object of the .gemini/settings.json file in your project:

"constellation": {
   "command": "npx",
   "args": [
      "-y",
      "@constellationdev/mcp@latest"
   ],
   "trust": true,
   "env": {
      "CONSTELLATION_ACCESS_KEY": "${CONSTELLATION_ACCESS_KEY}"
   }
}

JetBrains

📚 Official Documentation 🔗

Add the following property to the mcpServers object of the .ai/mcp/mcp.json file in your project:

"constellation": {
   "command": "npx",
   "args": [
      "-y",
      "@constellationdev/mcp@latest"
   ],
   "tools": ["code_intel"],
   "env": {
      "CONSTELLATION_ACCESS_KEY": "CONSTELLATION_ACCESS_KEY"
   }
}

Kilo Code

📚 Official Documentation 🔗

Add the following property to the mcpServers object of the .kilocode/mcp.json file in your project:

"constellation": {
   "command": "npx",
   "args": [
      "-y",
      "@constellationdev/mcp@latest"
   ],
   "alwaysAllow": ["code_intel"],
   "env": {
      "CONSTELLATION_ACCESS_KEY": "${env:CONSTELLATION_ACCESS_KEY}"
   }
}

OpenCode

📚 Official Documentation 🔗

Add the plugin to your project's opencode.json:

{
   "plugin": ["@constellationdev/opencode"]
}

OpenCode will automatically install the plugin at startup.

VSCode

📚 Official Documentation 🔗

There are multiple alternatives for configuring MCP servers in your project for use with GitHub Copilot.

Recommended: Click the following button to automatically install the Constellation MCP server with VSCode:

Add the following property to the servers object of the .vscode/mcp.json file in your project:

"constellation": {
   "type": "stdio",
   "command": "npx",
   "args": [
      "-y",
      "@constellationdev/mcp@latest"
   ],
   "tools": ["code_intel"],
   "env": {
      "CONSTELLATION_ACCESS_KEY": "CONSTELLATION_ACCESS_KEY"
   }
}

Windsurf

📚 Official Documentation 🔗

Add the following property to the mcpServers object of the Windsurf ~/.codeium/windsurf/mcp_config.json file:

"constellation": {
   "command": "npx",
   "args": [
      "-y",
      "@constellationdev/mcp@latest"
   ],
   "tools": ["code_intel"],
   "env": {
      "CONSTELLATION_ACCESS_KEY": "${env:CONSTELLATION_ACCESS_KEY}"
   }
}

Other / Generic

Typically you will find an mcpServers or servers section in a JSON configuration file for your AI tooling, or perhaps a .mcp.json file in your project root folder. Add an entry for the Constellation MCP server to the proper configuration file in the respective section.

Property	Value
name	`constellation`
type	`stdio`
command	`npx`
args	`-y`, `@constellationdev/mcp@latest`
allow tools	`code_intel`

JSON Example:

"constellation": {
   "type": "stdio",
   "command": "npx",
   "args": [
      "-y",
      "@constellationdev/mcp@latest"
   ]
}

Benefits

Speed

Code Mode is 10-15x faster than traditional sequential tool calls. Complex analyses that would take 30+ seconds now complete in 2-3 seconds.

Composability

Your AI can combine multiple API calls with custom logic, parallel execution via Promise.all(), and sophisticated data transformations all in a single execution.

Team-Wide Intelligence

All queries operate on your team's shared knowledge graph
Consistent and accurate results across all team members
Synchronized with your project's latest indexed changes

Graph-Powered Analysis

Deep understanding of code relationships and dependencies
Cross-file analysis that spans your entire codebase
Pattern recognition and architectural insights

Requirements

AI Assistant: Compatible AI coding assistant with MCP support (e.g., Claude Code, GitHub Copilot)
Node.js: Version 18 or higher
Constellation CLI: Must have a configured and indexed project
Authentication: Valid Constellation access key (configured via CLI or environment variable)

Quick Start

Install the MCP server in your AI assistant (see Installation above)
Authenticate:
```
constellation auth
```
Index your codebase:
```
constellation index
```
Ask your AI assistant questions like:
- "Find all uses of the UserService class"
- "What would be affected if I change this function?"
- "Are there any circular dependencies in this module?"
- "Summarize the architecture of this codebase"

Your AI assistant will automatically utilize Constellation to provide insightful and accurate answers!

Installation​

Benefits​

Speed​

Composability​

Team-Wide Intelligence​

Graph-Powered Analysis​

Requirements​

Quick Start​

Installation

Benefits

Speed

Composability

Team-Wide Intelligence

Graph-Powered Analysis

Requirements

Quick Start