{
  "markdown": "# Constellation MCP Server\n\n[![NPM Version](https://img.shields.io/npm/v/@constellationdev/mcp?logo=npm&logoColor=white)](https://www.npmjs.com/package/@constellationdev/mcp) ![TypeScript v5.9+](https://img.shields.io/badge/TypeScript-v5.9%2B-3178C6.svg?logo=typescript&logoColor=white) ![Node.js v24+](https://img.shields.io/badge/Node.js-v24%2B-5FA04E.svg?logo=node.js&logoColor=white) [![MCP Badge](https://lobehub.com/badge/mcp/shiftinbits-constellation-mcp?style=flat)](https://lobehub.com/mcp/shiftinbits-constellation-mcp) [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-3DA639?logo=opensourceinitiative&logoColor=white)](LICENSE) [![Snyk Monitored](https://img.shields.io/badge/Security-Monitored-8A2BE2?logo=snyk)](https://snyk.io/test/github/ShiftinBits/constellation-mcp)\n\nGive 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.\n\n## Quick Start\n\nAdd the Constellation MCP server to your AI assistant project-level config (or system-level if your tooling doesn't support project-level configuration):\n\n```json\n{\n  \"mcpServers\": {\n    \"constellation\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@constellationdev/mcp@latest\"],\n      \"env\": {\n        \"CONSTELLATION_ACCESS_KEY\": \"${CONSTELLATION_ACCESS_KEY}\"\n      }\n    }\n  }\n}\n```\n\n> [!NOTE]  \n> The above example is a generic format for the `.mcp.json` file used by some tools such as VSCode and Claude Code.\n>\n> Rather than directly configuring the MCP server, it is recommended to install and utilize official [Constellation Plugins](https://docs.constellationdev.io/plugins/) for optimal performance and behavior!\n>\n> For information on configuring other AI assistants see the [MCP Server > Installation doc](https://docs.constellationdev.io/mcp/#installation).\n\nFor further instructions regarding authentication, project setup, and configuration refer to the [official docs](https://docs.constellationdev.io/).\n\n## How It Works\n\n```mermaid\n%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#4A90E2', 'primaryTextColor': '#EEEEEE', 'primaryBorderColor': '#2B2C34', 'lineColor': '#4A90E2', 'secondaryColor': '#1F1F28', 'tertiaryColor': '#0B0C10', 'edgeLabelBackground': '#1F1F28' }}}%%\nflowchart LR\n    subgraph local[\"💻 Your Environment\"]\n        direction TB\n        code[\"📂 Source Code\"]\n        cli[\"⚙️ Constellation CLI\"]\n        ai[\"🤖 AI Coding Assistant\"]\n        mcp[\"🧩 Constellation MCP\"]\n        code --> cli\n    end\n\n    subgraph cloud[\"✨ Constellation Service\"]\n        direction TB\n        api[\"🔌  API\"]\n        graphdb[(\"🧠 Knowledge Graph\")]\n        api <--> graphdb\n    end\n\n    cli a1@-->|\"Metadata Upload\"| api\n    ai <-->|\"Tool Calls\"| mcp\n    mcp a2@<-->|\"Queries\"| api\n\n    a1@{ animation: fast }\n    a2@{ animation: fast }\n\n    style local fill:#1F1F28\n    style cloud fill:#1F1F28,stroke:#4A90E2\n    style cli stroke:#4A90E2\n    style mcp stroke:#4A90E2\n    style api stroke:#4A90E2\n    style graphdb stroke:#4A90E2\n```\n\n1. **Parse and Analyze**: The CLI tool analyzes source code in **_your_** environment, extracting structural metadata (functions, classes, variables, imports, calls, references, etc.)\n2. **Upload**: Only the metadata is securely sent to Constellation, never raw source code\n3. **Query**: AI assistants use the Constellation MCP tool to send complex queries, and get rapid answers derived from the knowledge graph\n\n## Documentation\n\nFind the full and comprehensive documentation at **[docs.constellationdev.io/mcp/](https://docs.constellationdev.io/mcp/)**\n\n- [Installation & Setup](https://docs.constellationdev.io/mcp/#installation) - Configure for Claude Code, Cursor, GitHub Copilot, and more\n- [Tools Reference](https://docs.constellationdev.io/mcp/tools) - Code Mode API and available methods\n- [Troubleshooting](https://docs.constellationdev.io/mcp/troubleshooting) - Common issues and solutions\n\n## Privacy & Security\n\n- **No source code transmission** - Only metadata and relationships\n- **Access control** - API keys required for all requests\n- **Branch isolation** - Each git branch maintains discrete code intelligence\n\nFor comprehensive information regarding privacy and security, see the [official Privacy & Security documentation](https://docs.constellationdev.io/privacy).\n\n## Support\n\n- Documentation: [docs.constellationdev.io](https://docs.constellationdev.io)\n- Report Issues: [GitHub Issues](https://github.com/shiftinbits/constellation-mcp/issues)\n\n## License\n\nAGPL-3.0 - See [LICENSE](LICENSE) for details.\n\nCopyright © 2026 ShiftinBits Inc.\n",
  "bytes": 4732,
  "sha": "ad0b0efa1f8d4aec4b0e15bbbe6c31078b98e665c7cbffb48cfbef1bf4bca792",
  "repo_slug": "shiftinbits/constellation-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_shiftinbits_constellation_8a185b09/readme"
}