A community-driven registry for the Claude Code ecosystem. Not affiliated with Anthropic.
Are you the author? Sign in to claim
AI-powered code search and analysis for Claude Code with advanced type extraction across 25+ languages. Lightning-fast L
A lightning-fast code search and navigation tool for Claude Code that helps you find files, search code, navigate symbols, and understand your projects instantly. Just ask Claude to "find all my React components", "show me recent changes", or "find the definition of UserService" and get results in milliseconds.
Built with .NET 9.0 and COA MCP Framework 2.1.8, featuring Lucene-powered search with AI-optimized responses.
: ITool, [Fact], and enhanced CamelCase tokenization with full generic type support (finds McpToolBase<TParams, TResult> when searching for "McpToolBase").coa/codesearch/indexes/ with multi-workspace supportThe type extraction system supports 25 programming languages using julie-codesearch, a Rust-based CLI tool with native tree-sitter bindings:
Core Languages (10):
Systems Languages (4):
Specialized Languages (11):
Special Features:
<script> blocks (TS/JS)@code and @functions blocks# Clone the repository
git clone https://github.com/anortham/coa-codesearch-mcp.git
cd coa-codesearch-mcp
# Build the project
dotnet build -c Release
# macOS/Linux
claude mcp add codesearch /path/to/coa-codesearch-mcp/COA.CodeSearch.McpServer/bin/Release/net9.0/COA.CodeSearch.McpServer
# Windows
claude mcp add codesearch C:\path\to\coa-codesearch-mcp\COA.CodeSearch.McpServer\bin\Release\net9.0\COA.CodeSearch.McpServer.exe
After adding:
Optional: Add to .gitignore
# CodeSearch local indexes (can be regenerated)
.coa/
Note: NuGet package installation will be available in a future release
Unlike basic file search, CodeSearch understands your code:
async Task, [Fact], interface IService patterns, plus enhanced CamelCase splitting for generic typesNote: All tools support smart defaults - most parameters are optional and default to sensible values. The workspacePath parameter defaults to the current workspace directory across all tools.
| Tool | Purpose | Key Parameters (all others optional) |
|---|---|---|
index_workspace | Index files for search | workspacePath (optional, defaults to current dir) |
text_search | Search file contents with semantic/fuzzy/regex modes | query (required), searchMode (optional: "auto", "exact", "fuzzy", "semantic", "regex") |
search_files | 🆕 Find files or directories by pattern | pattern (required), resourceType (optional: "file", "directory", "both") |
recent_files | Get recently modified files | timeFrame (optional, e.g., "2d", "1w") |
| Tool | Purpose | Key Parameters (all others optional) |
|---|---|---|
symbol_search | Find classes, interfaces, methods by name | symbol (required) |
find_references | Find all usages of a symbol | symbol (required) |
goto_definition | Jump to symbol definition | symbol (required) |
| Tool | Purpose | Key Parameters (all others optional) |
|---|---|---|
line_search | Get ALL occurrences with line numbers | pattern (required) |
search_and_replace | Replace patterns across files with preview and fuzzy matching | searchPattern (required), replacePattern (optional) |
| Tool | Purpose | Key Parameters (all others optional) |
|---|---|---|
smart_refactor | AST-aware symbol renaming with byte-offset precision | operation (required), params (required) |
| Tool | Purpose | Key Parameters (all others optional) |
|---|---|---|
edit_lines | 🆕 Unified line editing (insert/replace/delete) | filePath (required), operation (required: "insert", "replace", "delete"), startLine (required) |
| Tool | Purpose | Key Parameters (all others optional) |
|---|---|---|
get_symbols_overview | Extract all symbols from files | filePath (required) |
find_patterns | Detect code patterns and quality issues | filePath (required) |
trace_call_path | Hierarchical call chain analysis | symbol (required) |
Once installed, just chat naturally with Claude Code! Here are examples of what you can say:
"Find all my TypeScript files"
Claude will search for *.ts files in your project
"Show me all the async functions in my codebase"
Claude will search for patterns like "async function" and "async Task"
"Find files containing 'UserService'"
Claude will search file contents for the term "UserService"
"What files have been changed in the last 2 days?"
Claude will show recently modified files with timestamps
"Find all my React components"
Claude will look for .jsx, .tsx files and React patterns
"Show me all the test files"
Claude will find files with "test", "spec" in names or paths
"Find files similar to UserController.cs"
Claude will use content analysis to find structurally similar files
"Search for all database queries in my project"
Claude will look for SQL patterns, ORM calls, etc.
"Find the definition of UserService"
Claude will jump directly to where UserService class is defined
Shows exact line and column, with optional context snippet
"Show me all references to the UpdateUser method"
Claude will find all places where UpdateUser is called
Groups results by file for easy scanning
"Search for all classes ending with Controller"
Claude will find all classes matching the pattern like UserController, OrderController
Uses julie-codesearch tree-sitter-based extraction for accurate results across 25 languages
"Find where IRepository interface is implemented"
Claude will locate all implementations of the IRepository interface
Shows inheritance relationships and usage counts
"Find all classes and interfaces in my project"
Claude will extract types from 25 languages including C#, TypeScript, Python, Java, Rust, Go, C/C++, PHP, Ruby, Swift, Kotlin, and more
Uses julie-codesearch native tree-sitter extraction for LSP-quality results
"Show me all functions and methods in my codebase"
Claude will parse 25 languages and extract function/method definitions with signatures
Supports everything from C# to Bash to specialized languages like GDScript
"Find all Vue component methods"
Claude will parse Vue SFCs and extract methods from JavaScript/TypeScript script blocks
julie-codesearch handles embedded languages in templating systems
"Show me all Python classes with their methods"
Claude will analyze Python files and extract class definitions and methods
Full support for Python's class hierarchies and method signatures
"Find all Rust structs and impl blocks"
Claude will parse Rust code and extract struct definitions and implementations
julie-codesearch provides native Rust tree-sitter integration
"Index my project for searching"
Claude will scan and index your files for fast searching
"Find all TODO comments"
Claude will search for TODO, FIXME, HACK comments
"Show me configuration files"
Claude will find .json, .yaml, .config files
"Find all files in the Services directory that haven't been touched in 30 days"
Claude will use recent_files with a time filter to find stale code
"Search for error handling patterns in my C# code"
Claude will use text_search to find try-catch blocks and exception handling
"Find all API endpoints in my project"
Claude will search for route decorators and endpoint definitions
"Show me files that import React but don't use hooks"
Claude will combine multiple searches to find React imports without useState/useEffect
"Show me every line that contains 'Thread.Sleep'"
Claude will use line_search to find ALL occurrences with exact line numbers
Returns structured JSON instead of plain text grep output
"Find all console.log statements with their line numbers"
Claude will return every console.log with file path and line number
Perfect for cleanup tasks before production deployment
"Replace all 'var' declarations with 'let' in my JavaScript files"
Claude will use search_and_replace with preview mode first
Shows what will change before applying modifications
"Update all copyright headers to 2025"
Claude will find and replace copyright patterns across all files
Supports regex patterns for complex replacements
"Replace getUserData() even with typos using fuzzy matching"
Claude will use fuzzy mode with threshold 0.7-0.8
Finds: getUserData(), getUserDat() (typo), getUserData () (spacing), getUserDatta() (double-t)
Perfect for cleaning up inconsistent code patterns
"Fix method name variations across the codebase"
Claude will use fuzzy search to find all similar variations
Handles typos, spacing issues, and minor differences automatically
"Rename UserService to AccountService everywhere"
Claude will use smart_refactor with AST-aware symbol renaming
Finds all usages via SQLite identifiers table (LSP-quality)
Uses byte-offset replacement for precise, safe refactoring
"Refactor UpdateUser method name to UpdateUserAccount"
Claude will find ALL references using symbol analysis
Replaces at exact byte positions (not regex)
Preview mode shows exactly what will change before applying
The PathResolutionService implements comprehensive path validation:
Configuration via appsettings.json:
{
"CodeSearch": {
"BasePath": "~/.coa/codesearch",
"LogsPath": "~/.coa/codesearch/logs",
"Lucene": {
"IndexRootPath": ".coa/codesearch/indexes",
"MaxIndexingConcurrency": 8,
"RAMBufferSizeMB": 256,
"SupportedExtensions": [".cs", ".js", ".ts", ".py", ".java", ...]
},
"FileWatcher": {
"Enabled": true,
"DebounceMilliseconds": 500
},
"QueryCache": {
"Enabled": true,
"MaxCacheSize": 1000,
"CacheDuration": "00:15:00"
}
}
}
.coa/codesearch/indexes/[workspace-name_hash]/
~/.coa/codesearch/logs/ (global logging location)Built on COA MCP Framework 2.1.8:
# Debug build
dotnet build -c Debug
# Release build
dotnet build -c Release
# Run tests
dotnet test
# Test indexing
mcp__codesearch__index_workspace --workspacePath "."
# Test search
mcp__codesearch__text_search --query "LuceneIndexService"
# Test file discovery
mcp__codesearch__recent_files --timeFrame "7d"
"Claude says it can't find files I know exist"
Tell Claude: "Please index my project for searching first"
"Search results seem outdated"
Ask Claude: "Rebuild the search index for this project"
"Claude is responding slowly to search requests"
"Getting index lock errors"
Close Claude Code completely and restart it
Installation issues:
dotnet --versioncd coa-codesearch-mcp && dotnet build -c ReleaseBackground: Prior to v2.1.4, CodeSearch would fail to connect in workspaces other than the development workspace due to attempting to load instruction templates from a Templates/ directory that only existed in the source repository.
Solution: Templates are now embedded as resources in the assembly, ensuring they're always available regardless of workspace location. The codesearch-instructions.scriban template is compiled into the binary as an embedded resource.
Technical Details:
Templates/codesearch-instructions.scribanCOA.CodeSearch.McpServer.Templates.codesearch-instructions.scribanWithInstructionsFromTemplate) to resource-based (WithTemplateInstructions with embedded content)This change ensures CodeSearch works consistently across all workspaces without filesystem dependencies.
Set log levels in appsettings.json:
{
"Logging": {
"LogLevel": {
"COA.CodeSearch": "Information" // Debug, Trace for more detail
}
}
}
CodeSearch works seamlessly with other MCP servers configured in Claude Code:
Example workflow:
# 1. Search for code patterns using CodeSearch
mcp__codesearch__text_search --query "async Task"
# 2. Navigate to specific definitions
mcp__codesearch__goto_definition --symbol "UserService"
# 3. Find all references to a method
mcp__codesearch__find_references --symbol "UpdateUser"
MIT License - see LICENSE file.
Built with COA MCP Framework 2.1.8 • Powered by Lucene.NET
1000+ skills curated from Anthropic, Vercel, Stripe, and other engineering teams
@user_bdd01887CommunityDesign enforcement with memory — keeps your UI consistent across a project
Universal SEO skill for Claude Code. 25 sub-skills + 18 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, bac
Route Claude Code traffic to any of 17 provider backends including free or local models
