Codebase MCP Server
About
A server for secure and efficient codebase analysis.
Details
- Author
- myunghobae
- GitHub stars
- 3
- Downloads
- 170
- Categories
- Developer Tools, Other
Jump to
- Secure access restricts operations to a predefined root directory.
- Efficient file management for reading and searching files.
- Detailed file metadata retrieval (size, times, permissions, type).
- Dependency analysis by traversing project dependency trees.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Codebase MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via npx (npx codebase-mcp-server@latest /path/to/codebase) or Docker after building the image. Configure your MCP client (VS Code, Cursor, Windsurf, or Claude Desktop) with the server command and root directory. Once installed, invoke tools like get-project-basics or read-file-with-metadata through the MCP interface.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"codebase mcp server": {
"codebase-mcp-server": {
"command": "docker",
"args": [
"build",
"-t",
"mcp/codebase",
"-f",
"."
]
}
}
}
}McpServers
{
"codebase-mcp-server": {
"command": "docker",
"args": [
"build",
"-t",
"mcp/codebase",
"-f",
"."
]
}
}A server for secure and efficient codebase analysis.
Model Context Protocol server for secure and efficient Codebase analysis
Key Features•Supported Languages•Tools•QuickStart•Build•Contributing
- Secure Access: Restricts file operations to predefined root directory.
- Efficient File Management: Provides tools for reading and searching files.
- Detailed Metadata: Retrieves comprehensive file metadata including size, creation time, last modified time, permissions, and type.
- Dependency Analysis: Traverses and analyzes dependency trees within projects.
- JavaScript/TypeScript
- CSS / CSS Preprocessors
- get-project-basics: Retrieves essential project information including package.json details, directory structure.
- search-config-files: Searches for configuration files within the root directory and returns their paths.
- get-dependency-tree: Traverses the dependency tree based on the given file path and root directory, and returns the traversal results.
- list-directory: Lists the contents of a specified directory, distinguishing between files and directories.
- read-file-with-metadata: Reads the content of a specified file and retrieves its metadata.
- Node.js v18 or later
- Codebase to communicate with LLM
First, install the Codebase MCP server with your client. A typical configuration looks like this:
{ "mcpServers": { "Codebase": { "command": "npx", "args": ["codebase-mcp-server@latest", "/path/to/your/codebase"] } } }
Or, you can install the Codebase MCP server with Docker.
After cloning this repository, build the Docker image:
And then add the following to your MCP servers file:
{ "mcpServers": { "Codebase": { "command": "docker", "args": [ "run", "-i", "--rm", "--mount", "type=bind,src=/path/to/your/codebase/dir,dst=/projects/path/to/your/codebase/dir,ro", "--mount", "type=bind,src=/path/to/some/file.txt,dst=/projects/path/to/some/file.txt", "mcp/codebase", "/projects" ] } } }
Install in VS CodeYou can install the Codebase MCP server using the VS Code CLI:
# For VS Code code --add-mcp '{"name":"Codebase","command":"npx","args":["codebase-mcp-server@latest"]}'
After installation, the Codebase MCP server will be available for use with your GitHub Copilot agent in VS Code.
Install in CursorGo to Cursor Settings -> MCP -> Add new MCP Server. Use following configuration:
{ "mcpServers": { "Codebase": { "command": "npx", "args": ["codebase-mcp-server@latest"] } } }
Follow Windsuff MCP documentation. Use following configuration:
{ "mcpServers": { "Codebase": { "command": "npx", "args": ["codebase-mcp-server@latest"] } } }
Follow the MCP install guide, use following configuration:
{ "mcpServers": { "Codebase": { "command": "npx", "args": ["codebase-mcp-server@latest"] } } }
# Install dependencies npm ci # Build TypeScript npm run build
# Build Docker image docker build -t mcp/codebase -f . # Or with specific tag docker build -t mcp/codebase:latest -f .
Contributions are welcome! Please read our Contributing Guide for details on our Code of conduct and the process for submitting pull requests.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Create crafted UI components inspired by the best 21st.dev design engineers.
Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent
ALAPI MCP Tools,Call hundreds of API interfaces via MCP
AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform
MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.
APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.
One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.
Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
