메타데이터 기반 지식 그래프를 사용하여 AI 코딩 어시스턴트가 코드베이스 구조, 의존성 및 관계에 지능적으로 접근할 수 있도록 지원합니다.
다른 이름 ShiftinBits/constellation-mcp, constellation-mcp, @constellationdev/mcp
- 스타
- 3
- Tools
- —
- 다운로드, 30일
- 1,009
- 최신 버전
- 1.3.0
- 마지막 커밋
- 2026년 10월 27일
- 라이선스
- AGPL-3.0
Constellation MCP란?
메타데이터 기반 지식 그래프를 사용하여 AI 코딩 어시스턴트가 코드베이스 구조, 의존성 및 관계에 지능적으로 접근할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Constellation MCP server 정보
Constellation은 AI 코딩 어시스턴트가 코드베이스 구조, 의존성 및 관계에 지능적으로 접근할 수 있는 기능을 제공합니다. 메타데이터 기반 지식 그래프를 사용하여 함수, 클래스, 변수 및 import에 대한 통찰력을 도구에 제공하는 방식으로 작동합니다. 이 접근 방식을 통해 AI는 원본 소스 코드를 클라우드로 전송할 필요 없이 복잡한 코드 관계를 이해할 수 있습니다.
개발자는 npx를 통한 stdio 연결을 사용하여 서버를 설정합니다. 설정 시 인증을 위해 CONSTELLATION_ACCESS_KEY 환경 변수가 필요합니다. Claude Code 또는 Cursor와 같은 도구의 프로젝트 수준 또는 시스템 수준 설정에 추가할 수 있지만, 최상의 성능을 위해 공식 Constellation 플러그인을 사용하는 것을 권장합니다.
시스템은 3단계 프로세스로 작동합니다. 먼저 로컬 CLI 도구가 소스 코드를 파싱하여 구조적 메타데이터를 추출합니다. 이 메타데이터는 Constellation Service로 업로드되어 지식 그래프에 저장됩니다. 이후 AI 어시스턴트는 MCP server를 사용하여 API에 쿼리를 보내고 해당 그래프를 기반으로 신속한 답변을 받습니다.
활용 사례
- 1코드베이스 관계 분석프로젝트 전체에서 서로 다른 함수와 클래스가 어떻게 상호작용하는지 AI에게 식별하도록 요청합니다.
- 2분석 중 개인정보 보호 유지실제 소스 코드를 원격 서버로 전송하지 않고도 심층적인 코드 인텔리전스 작업을 수행합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Constellation MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Constellation MCP 설치
$ claude mcp add --env 'CONSTELLATION_ACCESS_KEY=<YOUR_CONSTELLATION_ACCESS_KEY>' constellation-mcp -- npx -y @constellationdev/mcpCursor에 Constellation MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"constellation-mcp": {
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "<YOUR_CONSTELLATION_ACCESS_KEY>"
}
}
}
}VS Code에 Constellation MCP 설치
.vscode/mcp.json
{
"servers": {
"constellation-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "<YOUR_CONSTELLATION_ACCESS_KEY>"
}
}
}
}VS Code CLI에 Constellation MCP 설치
$ code --add-mcp '{"name":"constellation-mcp","type":"stdio","command":"npx","args":["-y","@constellationdev/mcp"],"env":{"CONSTELLATION_ACCESS_KEY":"<YOUR_CONSTELLATION_ACCESS_KEY>"}}'Claude Desktop에 Constellation MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"constellation-mcp": {
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "<YOUR_CONSTELLATION_ACCESS_KEY>"
}
}
}
}Codex에 Constellation MCP 설치
$ codex mcp add constellation-mcp --env 'CONSTELLATION_ACCESS_KEY=<YOUR_CONSTELLATION_ACCESS_KEY>' -- npx -y @constellationdev/mcpCodex config.toml에 Constellation MCP 설치
~/.codex/config.toml
[mcp_servers.constellation-mcp] command = "npx" args = ["-y", "@constellationdev/mcp"] [mcp_servers.constellation-mcp.env] CONSTELLATION_ACCESS_KEY = "<YOUR_CONSTELLATION_ACCESS_KEY>"
Gemini CLI에 Constellation MCP 설치
$ gemini mcp add -s user -e 'CONSTELLATION_ACCESS_KEY=<YOUR_CONSTELLATION_ACCESS_KEY>' constellation-mcp npx -- -y @constellationdev/mcpGemini settings.json에 Constellation MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"constellation-mcp": {
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "<YOUR_CONSTELLATION_ACCESS_KEY>"
}
}
}
}구성
CONSTELLATION_ACCESS_KEY필수비밀Your Constellation access key
| 이름 | 설명 | 유형 |
|---|---|---|
| CONSTELLATION_ACCESS_KEY | Your Constellation access key | 필수비밀 |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능shiftinbits/constellation-mcp is public and reachablegithub.com/shiftinbits/constellation-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시@constellationdev/mcp names shiftinbits/constellation-mcp as sourcenpmjs.com/package/@constellationdev/mcp ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for @constellationdev/mcpnpmjs.com/package/@constellationdev/mcp/v/1.3.0#provenance ↗통과
- 오픈 소스 라이선스 (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-27github.com/shiftinbits/constellation-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @constellationdev/mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음7 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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.jsonfile 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.
Copyright © 2026 ShiftinBits Inc.
Constellation MCP 질문
Constellation MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'CONSTELLATION_ACCESS_KEY=<YOUR_CONSTELLATION_ACCESS_KEY>' constellation-mcp -- npx -y @constellationdev/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Constellation MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Constellation이 소스 코드를 전송하나요?
아니요, 서비스는 구조적 메타데이터와 관계만 전송하며 원본 소스 코드는 절대 전송하지 않습니다.
Constellation MCP server를 어떻게 설치하나요?
CONSTELLATION_ACCESS_KEY 환경 변수와 함께 npx를 사용하여 @constellationdev/mcp@latest를 실행함으로써 AI 어시스턴트 설정에 추가할 수 있습니다.
코드 분석 프로세스는 어떻게 작동하나요?
CLI 도구가 환경 내의 소스 코드를 분석하여 함수, 클래스, import와 같은 구조적 메타데이터를 추출하며, 추출된 데이터는 지식 그래프로 업로드됩니다.