willibrandon/NetContextServer

🔍 Supercharge Your AI Coding Assistant with Deep .NET Codebase Understanding
NetContextServer empowers AI coding assistants like VS Code to deeply understand your .NET codebase through the Model Context Protocol (MCP). This means more accurate code suggestions, better answers to your questions, and a more productive coding experience.
## ✨ Key Features
🧠 Semantic Code Search: Find code by describing what you're looking for in natural language
🔍 Intelligent Navigation: Help AI tools understand your project structure and dependencies
🛡️ Built-in Security: Safe file access with automatic protection of sensitive data
🚀 VS Code Integration: Seamless setup with VS Code for enhanced coding assistance
📦 Package Analysis: Understand your dependencies and get update recommendations
🔍 Deep Dependency Visualization: See transitive dependencies with interactive, color-coded graphs
🧩 Smart Grouping: Visually group related packages for easier navigation
📊 Update Recommendations: Identify outdated packages and security issues
📊 Test Coverage Analysis: Deep insights into your test coverage
🎯 Multi-Format Support: Parse coverage data from Coverlet, LCOV, and Cobertura XML
📈 Detailed Reports: File-level coverage percentages and uncovered line tracking
🔄 Branch Coverage: Track method-level branch coverage where available
💡 Smart Recommendations: Get suggestions for improving test coverage
⚡ Fast & Efficient: Quick indexing and response times for large codebases
## 🚀 Quick Start
1. Clone & Build:
bash
git clone https://github.com/willibrandon/NetContextServer.git
cd NetContextServer
dotnet build
2. Set Up (optional, for semantic search):
bash
# Set Azure OpenAI credentials in environment:
AZUREOPENAIENDPOINT=yourendpoint
AZUREOPENAIAPIKEY=yourkey
3. Start Using:
bash
# Point to your project
dotnet run --project src/NetContextClient/NetContextClient.csproj -- set-base-dir --directory "path/to/your/project"
# Try semantic search
dotnet run --project src/NetContextClient/NetContextClient.csproj -- semantic-search --query "find authentication logic"
👉 Read our Getting Started Guide for detailed setup instructions and best practices.
## 🔌 Integration with VS Code
1. Open Visual Studio Code
2. Press Ctrl + Shift + P (or Cmd + Shift + P on macOS)
3. Type "Configure MCP Server"
4. Enter:
json
"command": "dotnet",
"args": ["run", "--project", "path/to/NetContextServer/src/NetContextServer/NetContextServer.csproj"]
Now VS Code can understand your codebase! Try asking it questions like:
"List all .NET source files in this project directory"
"Search for exact text matches in the code files"
"Analyze NuGet packages in all projects"
"Get the current list of ignore patterns"
"Add these ignore patterns: .generated.cs, bin/"
"List all .csproj files in this directory"
"Show me the contents of this file"
"What's the current base directory for file operations?"
"Help me think through the authentication system design"
"Document my reasoning about this architectural decision"
"Analyze test coverage for MyService.cs"
"Show me uncovered lines in the authentication module"
"What's the overall test coverage percentage?"
"Which files have the lowest test coverage?"
## 📚 Documentation