Releases: drewdrewH/code-graph-context
Releases · drewdrewH/code-graph-context
v0.1.0 - Initial Release
Release v0.1.0
Initial public release of Code Graph Context MCP Server - a Model Context Protocol server that provides rich code graph context to LLMs through semantic search and intelligent graph traversal.
🎉 Major Features
Weighted Graph Traversal
- Intelligent path scoring using relationship weights, semantic similarity, and depth penalties
- Configurable traversal modes for different use cases (exhaustive vs. relevant)
- Depth-by-depth exploration with automatic pruning of low-relevance paths
- Default weights for core TypeScript and framework-specific relationships
NPM Package Distribution
- Published as
code-graph-contexton npm - Simple global install:
npm install -g code-graph-context - Flexible Neo4j configuration via environment variables
- Works with local, Docker, cloud (Aura), or enterprise Neo4j instances
Enhanced Documentation
- Comprehensive weighted traversal guide with scoring algorithm details
- Claude Code integration tips for
claude.mdfiles - Trigger word hints and query patterns
- Framework-specific usage examples
🚀 Features
- Rich Code Graph Generation: Parse TypeScript/NestJS projects into detailed Neo4j graphs
- Semantic Search: OpenAI embedding-based search for finding relevant code
- Weighted Traversal: Smart exploration prioritizing important relationships
- Framework-Aware: Built-in NestJS support with extensible schema system
- MCP Integration: Seamless Claude Code integration
📦 Installation
# Install globally via npm
npm install -g code-graph-context
# Set up Neo4j (Docker)
docker run -d \
--name code-graph-neo4j \
-p 7474:7474 -p 7687:7687 \
-e NEO4J_AUTH=neo4j/PASSWORD \
-e NEO4J_PLUGINS='["apoc"]' \
neo4j:5.15
# Add to Claude Code
claude mcp add code-graph-context code-graph-context🔧 Technical Improvements
- Add
relationshipWeightproperty to edge schema interfaces - Implement
RelationshipExtractorfor declarative edge definitions - Add deferred edge resolution for EXTENDS/IMPLEMENTS relationships
- Depth-by-depth Cypher query with combined scoring
- Framework edge weights (NestJS, FairSquare)
- Increase default code snippet length to 1000 chars
📝 Documentation
- Weighted traversal scoring algorithm documentation
- NPM package installation guide
- Claude Code integration patterns
- Framework-specific node types and relationships
- Common query examples
🐛 Bug Fixes
- Fix package.json bin path format
- Normalize repository URL
📚 Requirements
- Node.js >= 18
- Neo4j >= 5.0 with APOC plugin
- OpenAI API Key
🔗 Links
- NPM Package: https://www.npmjs.com/package/code-graph-context
- GitHub: https://github.com/drewdrewH/code-graph-context
- Documentation: See README.md
Full Changelog: https://github.com/drewdrewH/code-graph-context/commits/v0.1.0