Coa Codenav Mcp

COA CodeNav MCP Server

A powerful MCP (Model Context Protocol) server providing comprehensive C# and TypeScript code analysis and navigation tools for AI assistants. Built on Microsoft's Roslyn compiler platform and TypeScript Server Protocol, it brings Visual Studio's IntelliSense and advanced code navigation capabilities to AI, enabling deep understanding and manipulation of codebases.

🚀 Features

Auto-Loading System ⚡

• Zero Configuration - Solutions and TypeScript projects load automatically at startup
• Multi-Language Support - Simultaneous C# and TypeScript workspace initialization
• Smart Discovery - Automatically finds .sln, .csproj, and tsconfig.json files
• Background Loading - Non-blocking startup with parallel workspace preparation
• Graceful Fallbacks - Falls back to manual loading if auto-detection fails

C# Analysis (Roslyn)

• Complete C# Code Analysis - Full Roslyn compiler integration for accurate code understanding
• 31 Powerful Tools - Comprehensive suite covering navigation, analysis, refactoring, and code generation
• Advanced Refactoring - Extract methods/interfaces, inline code, move types, rename symbols, and more
• Deep Analysis - Code metrics, dependency analysis, clone detection, and call hierarchies

TypeScript Analysis (TSP)

• TypeScript Server Protocol - Native TSP integration for accurate TypeScript analysis
• 14 Comprehensive Tools - Full suite covering navigation, analysis, refactoring, and workspace management
• Advanced Features - Imports management, quick fixes, workspace loading, and symbol hierarchies
• Project Management - Load tsconfig.json projects with full monorepo workspace support
• Real-time Diagnostics - Compilation error detection with intelligent fixes

AI-Optimized Experience

• AI-First Design - Structured outputs with insights, next actions, and error recovery
• Smart Token Management - Automatic response truncation to prevent context overflow
• Progressive Disclosure - Automatic response summarization for large results
• Intelligent Hooks - Claude Code integration with smart type verification suggestions
• Cross-platform Support - Windows, macOS, and Linux compatibility

📦 Installation

Prerequisites

• .NET 9.0 SDK or later
• Windows, macOS, or Linux
• AI assistant with MCP support (Claude Desktop, etc.)
• For TypeScript: TypeScript installed globally (npm install -g typescript)

Quick Install (Recommended)

Via dotnet global tool

# Install the global tool from NuGet
dotnet tool install --global COA.CodeNav.McpServer

# Add to Claude Desktop configuration
# The tool will be available as 'coa-codenav' command

Manual Claude Desktop Configuration

Add to your Claude configuration file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS/Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "coa-codenav": {
      "command": "coa-codenav"
    }
  }
}

Alternative: Build from Source

# Clone and build
git clone https://github.com/anortham/coa-codenav-mcp.git
cd coa-codenav-mcp
dotnet build -c Release

# Add to Claude Desktop configuration
# Windows
"command": "C:\\path\\to\\coa-codenav-mcp\\COA.CodeNav.McpServer\\bin\\Release\\net9.0\\COA.CodeNav.McpServer.exe"

# macOS/Linux
"command": "/path/to/coa-codenav-mcp/COA.CodeNav.McpServer/bin/Release/net9.0/COA.CodeNav.McpServer"

Update Tool

# Update to latest version
dotnet tool update --global COA.CodeNav.McpServer

Uninstall Tool

# Remove global tool
dotnet tool uninstall --global COA.CodeNav.McpServer

🛠️ Available Tools

Quick Reference

> 💡 New: With auto-loading enabled, solutions and TypeScript projects load automatically - no manual loading required!

C# Tools (31 tools)

| Tool | Purpose | Example Usage | | ---------------------------- | ---------------------- | ----------------------------------- | | csharp_load_solution | Load VS solution | "Load MyApp.sln" | | csharp_goto_definition | Jump to definition | "Go to UserService definition" | | csharp_find_all_references | Find usages | "Where is ProcessOrder used?" | | csharp_symbol_search | Search symbols | "Find all \Service classes" | | csharp_get_diagnostics | Get errors/warnings | "Show me all errors" | | csharp_rename_symbol | Rename across solution | "Rename UserService to UserManager" | | csharp_extract_interface | Extract interface | "Extract IUserService interface" | | csharp_move_type | Move type to new file | "Move User class to User.cs" | | csharp_inline_method | Inline method calls | "Inline the helper method" | | csharp_call_hierarchy | View call graph | "Show who calls ProcessOrder" | | csharp_code_clone_detection| Find duplicate code | "Find duplicated code blocks" |

*Only needed if auto-loading fails or for additional solutions

TypeScript Tools (14 tools)

| Tool | Purpose | Example Usage | | ---------------------------- | -------------------------- | ----------------------------------- | | ts_load_tsconfig | Load TypeScript project | "Load tsconfig.json" | | ts_load_workspace | Load multi-project workspace | "Load TypeScript monorepo" | | ts_goto_definition | Navigate to definitions | "Go to UserService definition" | | ts_find_all_references | Find symbol references | "Where is processOrder used?" | | ts_find_implementations | Find interface implementations | "Find all User implementations" | | ts_get_diagnostics | Get TypeScript errors | "Check for TypeScript errors" | | ts_hover | Get symbol information | "What does this function do?" | | ts_document_symbols | Extract file structure | "Show all classes and methods" | | ts_symbol_search | Search for symbols | "Find all *Service classes" | | ts_rename_symbol | Rename across files | "Rename UserService to UserManager" | | ts_call_hierarchy | Analyze call relationships | "Show call hierarchy for function" | | ts_add_missing_imports | Auto-add import statements | "Add missing imports to file" | | ts_organize_imports | Sort and organize imports | "Clean up import statements" | | ts_apply_quick_fix | Apply TypeScript fixes | "Fix this TypeScript error" |

*Only needed if auto-loading fails or for additional projects

🔄 Auto-Loading System

The MCP server now features an intelligent auto-loading system that automatically discovers and loads your projects at startup, eliminating the need for manual workspace setup in most cases.

How Auto-Loading Works

1. Startup Detection: When the MCP server starts, it scans the current directory and subdirectories
2. Multi-Language Discovery: Simultaneously searches for:

• C# solutions (.sln files)
• C# projects (.csproj files)
• TypeScript configs (tsconfig.json files)

1. Smart Prioritization: Prefers solutions over individual projects, respects configuration preferences
2. Background Loading: Loads workspaces in parallel without blocking the server startup
3. Graceful Fallbacks: Falls back to manual loading if auto-detection fails

Configuration (appsettings.json)

{
  "Startup": {
    "AutoLoadSolution": true,              // Enable auto-loading
    "SolutionPath": "MyApp.sln",          // Preferred solution name
    "MaxSearchDepth": 5,                   // Directory search depth
    "PreferredSolutionName": "MyApp",      // Preferred solution prefix
    "RequireSolution": false               // Allow project-only loading
  },
  "CodeSearch": {
    "BaseUrl": "http://localhost:5020"     // CodeSearch service URL for development
  }
}

Environment Variables

For production deployments, configure the CodeSearch service URL via environment variables:

# Production deployment
export CODENAV_CODESEARCH_URL="https://codesearch-service:8080"

# Docker/Container deployment
export CODENAV_CODESEARCH_URL="http://codesearch-service:5020"

# Kubernetes deployment
export CODENAV_CODESEARCH_URL="http://codesearch-service.default.svc.cluster.local:5020"

Configuration Priority (highest to lowest):

1. Environment variable CODENAV_CODESEARCH_URL
2. Configuration section CodeSearch:BaseUrl
3. Default development URL http://localhost:5020

Security Note: Never use localhost URLs in production environments. Always configure appropriate service URLs for your deployment target.

Auto-Loading Status

Use csharp_get_workspace_statistics to check if auto-loading succeeded:

{
  "totalWorkspaces": 1,
  "workspaceDetails": [{
    "workspaceId": "C:\\Projects\\MyApp\\MyApp.sln",
    "loadedPath": "C:\\Projects\\MyApp\\MyApp.sln",
    "createdAt": "2025-01-20T10:30:00Z",
    "lastAccessedAt": "2025-01-20T10:35:00Z"
  }]
}

When Manual Loading is Still Needed

• Additional Solutions: Loading secondary solutions not in the startup directory
• Specific Projects: Loading individual projects when solution auto-loading fails
• Remote Paths: Loading solutions from network locations or different drives
• Multi-Workspace: Working with multiple unrelated solutions simultaneously

Benefits of Auto-Loading

• ✅ Zero Configuration - Works out of the box for most projects
• ✅ Faster Startup - Parallel loading reduces time to first usable state
• ✅ Multi-Language - Handles C# and TypeScript projects simultaneously
• ✅ Intelligence Ready - Type verification and navigation tools available immediately
• ✅ Backward Compatible - Manual loading still available when needed

Workspace Management

csharp_load_solution

Load a complete Visual Studio solution for analysis (typically only needed if auto-loading fails or for additional solutions).

When to use:

• "Load the MyApp.sln solution"
• "Open the solution file in C:\Projects\MyApp"
• "I want to analyze this C# solution"

Example:

{
  "solutionPath": "C:\\Projects\\MyApp\\MyApp.sln",
  "workspaceId": "optional-custom-id"
}

csharp_load_project

Load a single C# project file.

When to use:

• "Load just the MyApp.Core project"
• "Open the csproj file"
• "I only need to analyze this one project"

Example:

{
  "projectPath": "C:\\Projects\\MyApp\\MyApp.Core\\MyApp.Core.csproj"
}

csharp_get_workspace_statistics

Get statistics about loaded workspaces and resource usage.

When to use:

• "Show workspace memory usage"
• "How many workspaces are loaded?"
• "Check workspace performance"

Code Navigation

csharp_goto_definition

Navigate to the definition of a symbol at a specific position.

When to use:

• "Where is UserService defined?"
• "Show me the definition of ProcessOrder method"
• "Jump to where this class is declared"

Example:

{
  "filePath": "Program.cs",
  "line": 42,
  "column": 25
}

Response includes:

• Exact location of definition
• Symbol type and signature
• Next actions (find references, implementations, etc.)

csharp_find_all_references

Find all references to a symbol across the entire codebase.

When to use:

• "Where is UserService used?"
• "Find all calls to ProcessOrder"
• "Show me all references to this variable"

Example:

{
  "filePath": "Services/UserService.cs",
  "line": 15,
  "column": 20,
  "maxResults": 100
}

Features:

• Groups results by file
• Shows usage context
• Handles large result sets with pagination

csharp_find_implementations

Find all implementations of interfaces and overrides of virtual/abstract methods.

When to use:

• "What classes implement IRepository?"
• "Show me all implementations of this interface"
• "What overrides ProcessOrder?"

csharp_hover

Get detailed information about a symbol including signature, documentation, and type info.

When to use:

• "What does this method do?"
• "Show me the documentation for ProcessOrder"
• "What parameters does this function take?"

Code Search & Discovery

csharp_symbol_search

Search for symbols by name or pattern across the entire solution.

When to use:

• "Find all classes with 'Service' in the name"
• "Search for methods starting with 'Process'"
• "Find the UserController class"
• "Show me all interfaces in the Data namespace"

Search types:

• contains - Partial match anywhere in name (default)
• exact - Exact name match
• startswith - Name starts with query
• endswith - Name ends with query
• wildcard - Support \* and ? wildcards
• regex - Full regex patterns
• fuzzy - Fuzzy matching for typos

Example:

{
  "query": "User*Service",
  "searchType": "wildcard",
  "symbolKinds": ["Class", "Interface"],
  "namespaceFilter": "MyApp.Services",
  "maxResults": 50
}

csharp_document_symbols

Extract the complete symbol hierarchy from a file.

When to use:

• "Show me the structure of this file"
• "What methods are in UserService.cs?"
• "Give me an outline of this class"

csharp_get_type_members

List all members of a type including methods, properties, fields, and events.

When to use:

• "What methods does UserService have?"
• "Show me all properties of Order class"
• "List members including inherited ones"

Code Analysis

csharp_get_diagnostics

Get compilation errors, warnings, and analyzer diagnostics.

When to use:

• "Show me all errors in the solution"
• "What warnings do I have?"
• "Check for nullable reference warnings"
• "Find code quality issues"

Example:

{
  "scope": "solution",
  "severities": ["Error", "Warning"],
  "includeAnalyzers": true,
  "idFilter": "CS8", // Filter for specific diagnostic IDs
  "maxResults": 50
}

csharp_code_metrics

Calculate code complexity and maintainability metrics.

When to use:

• "Calculate complexity of this method"
• "Find methods that are too complex"
• "Show maintainability index for this class"
• "Identify refactoring candidates"

Metrics provided:

• Cyclomatic Complexity - Number of code paths
• Lines of Code - Logical lines of code
• Maintainability Index - 0-100 score (higher is better)
• Depth of Inheritance - Inheritance hierarchy depth
• Class Coupling - Number of coupled classes

csharp_find_unused_code

Find potentially unused code elements including classes, methods, properties, and fields.

When to use:

• "Find dead code in the project"
• "Show me unused private methods"
• "Clean up unused classes"
• "Identify code that can be removed"

csharp_type_hierarchy

View the complete type hierarchy including base classes, derived types, and interface implementations.

When to use:

• "Show inheritance hierarchy of UserService"
• "What classes derive from BaseController?"
• "View the complete type hierarchy"
• "What interfaces does this class implement?"

Advanced Analysis

csharp_call_hierarchy

View bidirectional call graph showing incoming and outgoing calls.

When to use:

• "Show all callers of this method"
• "What methods does this function call?"
• "View complete call hierarchy"
• "Understand method dependencies"

csharp_find_all_overrides

Find all overrides of virtual/abstract methods and properties.

When to use:

• "What overrides this virtual method?"
• "Find all implementations of abstract method"
• "Show override hierarchy"

`

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: anortham
• Source: anortham/coa-codenav-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.