Constellation

Name: Constellation
Author: ShiftinBits

本地服务

github.com/ShiftinBits开发工具33 天前更新

代码仓库

关于 Constellation

Constellation 是面向 AI 编码 Agent 的代码智能 MCP 服务，可提供代码结构与关系信息，而不传输源代码。本地 CLI 分析代码并发送元数据，供 Agent 查询。

主要功能

01分析函数、类、导入和引用
02基于结构元数据构建代码智能
03将原始源代码保留在本地
04按 Git 分支维护独立代码信息
05请求需要 API 密钥

适用场景

01向 AI 编码 Agent 查询代码关系
02借助结构化上下文浏览代码库
03查询特定分支的代码信息

MCP 相关

MCP 服务向 AI 助手提供查询 Constellation 代码知识图谱的工具；本地 CLI 分析代码并上传元数据，而非源代码。

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

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "constellation": {
      "command": "npx",
      "args": [
        "-y",
        "@constellationdev/mcp"
      ],
      "env": {
        "CONSTELLATION_ACCESS_KEY": "<CONSTELLATION_ACCESS_KEY>"
      }
    }
  }
}

启动命令npx -y @constellationdev/mcp

需要配置的环境变量

CONSTELLATION_ACCESS_KEY密钥Your Constellation access key

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@constellationdev/mcp1.3.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
code	string	是	要执行的 JavaScript 代码。可使用顶层 await。可用 API 方法：searchSymbols、getSymbolDetails、getDependencies、getDependents、findCircularDependencies、traceSymbolUsage、getCallGraph、impactAnalysis、findOrphanedCode、getArchitectureOverview
cwd	string	是	正在查询的项目目录的绝对路径。通过查找 git 仓库根目录来定位正确的 constellation.json。将其设置为你正在使用的仓库根目录或工作区文件夹。
timeout	number	否	最大执行时间，单位为毫秒（默认值：30000，最大值：60000）

详细介绍

Constellation MCP 服务

让你的 AI 编码助手即时、智能地访问整个代码库的结构、依赖关系和关联信息，无需传输任何源代码。Constellation 为 AI 编码助手工具提供代码智能服务。

快速开始

将 Constellation MCP 服务添加到你的 AI 助手项目级配置中（如果你的工具不支持项目级配置，则添加到系统级配置中）：

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

说明

上述示例是 .mcp.json 文件的一种通用格式，VSCode 和 Claude Code 等工具会使用此类文件。

为了获得最佳性能和使用体验，建议安装并使用官方的 Constellation Plugins，而不是直接配置 MCP 服务！

有关配置其他 AI 助手的信息，请参阅 MCP Server > Installation doc。

有关身份验证、项目设置和配置的更多说明，请参阅官方文档。

工作原理

%%{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