Codebase MCP Server
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
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Codebase MCP Serveringest the codebase at /Users/dev/my-react-app"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: Codebase MCP
Installation
Global Installation (Recommended)
# Install globally with Bun
bun install -g @codebase-mcp/server
# Or install globally with npm
npm install -g @codebase-mcp/serverLocal Development Installation
# Clone the repository
git clone https://github.com/your-username/codebase-mcp-server.git
cd codebase-mcp-server
# Install dependencies
bun install
# Build the project
bun run build
# Install globally from local build
bun run install-globalConfiguration
With Claude Code (Console/CLI)
Add the MCP server using the Claude Code CLI:
# Add the MCP server (local scope - for current project)
claude mcp add codebase-mcp codebase-mcp
# Or add for user scope (available across all projects)
claude mcp add --scope user codebase-mcp codebase-mcp
# Verify it was added
claude mcp listWith Claude Desktop
Add to your Claude Desktop settings:
{
"mcps": {
"codebase-mcp": {
"command": "codebase-mcp",
"env": {}
}
}
}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:
Hey Claude, can you ingest the codebase at /path/to/my-project?Multi-Project Usage
Single Instance (Project Switching)
Within one Claude Code instance, switch between projects:
Claude, ingest the React app at /Users/me/my-react-app
Claude, now switch to analyze the Python project at /Users/me/my-python-project
Claude, go back to the React app and show me the component structureMultiple Instances (Concurrent Projects)
Each Claude Code instance runs its own isolated MCP server process:
Project A (Claude Code in