Detects and analyzes Angular projects with framework-specific insights
Analyzes CSS stylesheets within projects
Detects and processes environment files (.env*) for configuration analysis
Respects .gitignore patterns when analyzing codebases
Analyzes JavaScript codebases including .js and .jsx files across any framework
Analyzes Less stylesheet files within codebases
Processes Markdown documentation files for project context
Supports analysis of Python projects with appropriate file categorization
Identifies React projects, analyzes component structures, and provides pattern detection for React codebases
Supports analysis of Sass (.scss, .sass) stylesheet files
Supports Svelte component analysis with automatic detection of Svelte-based projects
Analyzes TOML configuration files within projects
Provides analysis for TypeScript files including .ts and .tsx with tsconfig.json parsing
Analyzes Vite projects with deep codebase insights, providing structure and framework detection capabilities
Supports YAML configuration file analysis
Codebase MCP Server
A Model Context Protocol (MCP) server that analyzes any application codebase with real-time file watching, providing AI assistants like Claude with deep insights into your project structure, code patterns, and architecture.
Features
Universal Codebase Analysis: Works with any programming language or framework (not just Vite)
Real-time File Watching: Automatically stays synchronized with file system changes
Smart Framework Detection: Identifies React, Vue, Svelte, Angular, or vanilla projects
Intelligent Filtering: Excludes node_modules, build files, and other non-essential content
File Categorization: Organizes files into source, config, test, documentation, and build categories
Content Search: Search files by name patterns, content, type, or category
Multi-project Support: Switch between different projects seamlessly
Global Installation: Install once, use anywhere
Installation
Global Installation (Recommended)
Local Development Installation
Configuration
With Claude Code (Console/CLI)
Add the MCP server using the Claude Code CLI:
With Claude Desktop
Add to your Claude Desktop settings:
Usage
Quick Start
Install the MCP server globally (see installation above)
Configure Claude Code/Desktop with the MCP server
Restart Claude Code/Desktop
Analyze any codebase:
Multi-Project Usage
Single Instance (Project Switching)
Within one Claude Code instance, switch between projects:
Multiple Instances (Concurrent Projects)
Each Claude Code instance runs its own isolated MCP server process:
Project A (Claude Code in
/path/to/project-a/
): Own MCP server with PID 1234Project B (Claude Code in
/path/to/project-b/
): Own MCP server with PID 5678Project C (Claude Code in
/path/to/project-c/
): Own MCP server with PID 9012
Each instance maintains its own:
File index and project structure
File watcher for real-time updates
Independent state and memory
No conflicts or interference between projects!
Real-time Synchronization
Once a codebase is ingested, the server automatically:
Monitors all file changes in real-time
Updates the file index when files are created, modified, or deleted
Re-analyzes project structure automatically
Keeps Claude's understanding up-to-date with your changes
Available Tools
ingest_codebase
Analyzes a Vite project from a given path.
get_project_structure
Returns the complete project analysis including:
Framework detection
File distribution by category
Directory structure
Package.json analysis
Key dependencies
search_files
Search for files by various criteria:
Available Resources
Once a codebase is ingested, you can access:
project://structure
- Complete project structure as JSONproject://summary
- Human-readable project summaryfile://path/to/file
- Individual file contents
Example Workflow
Supported File Types
Source Files
JavaScript/TypeScript (
.js
,.ts
,.jsx
,.tsx
)Vue components (
.vue
)Svelte components (
.svelte
)Stylesheets (
.css
,.scss
,.sass
,.less
)
Configuration Files
package.json
,vite.config.*
,tsconfig.json
Environment files (
.env*
)Other config formats (
.yaml
,.toml
, etc.)
Documentation
Markdown files (
.md
)README files
Documentation directories
Configuration
The server intelligently excludes common directories and files:
Excluded by Default
node_modules/
dist/
,build/
.git/
,.vscode/
,.idea/
coverage/
,.nyc_output/
Log files and OS files
File Size Limits
Maximum file size: 1MB
Maximum directory depth: 10 levels (configurable)
Security
Local only: Runs entirely on your local machine
No internet required: All processing happens locally
Selective access: Only reads files you explicitly point it to
Respects .gitignore patterns: Won't expose sensitive files
Troubleshooting
Common Issues
"Path does not exist": Ensure the provided path is correct and accessible
"No package.json found": This is just a warning - the server works with any codebase
Permission errors: Ensure the server has read access to the target directory
Multiple Instance Debugging
Each MCP server instance shows its Process ID (PID) for debugging:
Check running instances:
Verify isolation:
Each Claude Code instance should show a different PID
File changes in Project A should only affect that instance
Each instance can watch different codebases simultaneously
Debug Mode
Contributing
This is a generic Vite MCP server that can be extended for specific needs:
Add support for other build tools (Webpack, Rollup, etc.)
Implement more sophisticated code analysis
Add support for monorepos
Include dependency graph analysis
License
MIT License - feel free to modify and distribute as needed.
Next Steps
After setting up:
Configure Claude Code to use this MCP server
Point it at one of your Vite projects
Start asking Claude about your codebase structure
Use Claude to generate code that follows your existing patterns
The server provides deep context about your codebase, enabling much more accurate and relevant assistance from Claude.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A Model Context Protocol server that analyzes application codebases with real-time file watching, providing AI assistants like Claude with deep insights into project structure, code patterns, and architecture.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables LLMs to read, search, and analyze code files with advanced caching and real-time file watching capabilities.Last updated -6530MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI agents to retrieve and understand entire codebases at once, providing tools to analyze local workspaces or remote GitHub repositories.Last updated -354MIT License
- -securityFlicense-qualityA server component of the Model Context Protocol that provides intelligent analysis of codebases using vector search and machine learning to understand code patterns, architectural decisions, and documentation.Last updated -11
- AsecurityFlicenseAqualityA comprehensive Model Context Protocol server for advanced code analysis that provides tools for syntax analysis, dependency visualization, and AI-assisted development workflow support.Last updated -284