mcpField
C
Codebase MCP Server

Codebase MCP Server

Local
github.com/MyunghoBaeDeveloper Tools3Updated 70w ago
Repository

About Codebase MCP Server

Codebase MCP Server is an MCP server for analyzing JavaScript/TypeScript and CSS projects. It gives coding agents and other MCP clients bounded file access, project details, metadata, and dependency-tree analysis.

Key features

  1. 01Restrict file access to a root directory
  2. 02Read and search project files
  3. 03Retrieve file metadata
  4. 04Inspect project basics and structure
  5. 05Find configuration files
  6. 06Traverse dependency trees

Use cases

  1. 01Review a project's package and directory structure
  2. 02Locate configuration files in a codebase
  3. 03Inspect a file and its metadata
  4. 04Trace dependencies from a file

MCP support

It exposes codebase analysis tools to MCP clients, including file listing and reading, project information, configuration discovery, and dependency traversal. File operations are limited to a predefined root directory.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "codebase": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
Run commanddocker run -i --rm build

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocibuild

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Codebase MCP Server

Model Context Protocol server for secure and efficient Codebase analysis

License npm version

Key Features • Supported Languages • Tools • QuickStart • Build • Contributing

🌟 Key Features

  • 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.

📋 Supported Languages

  • JavaScript/TypeScript
  • CSS / CSS Preprocessors

🛠️ Tools

  • 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.

🚀 QuickStart

Prerequisites
  • Node.js v18 or later
  • Codebase to communicate with LLM
Installation

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:

docker build -t mcp/codebase -f .

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 Code You 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 Cursor Go to Cursor Settings -> MCP -> Add new MCP Server. Use following configuration: 
{
  "mcpServers": {
    "Codebase": {
      "command": "npx",
      "args": ["codebase-mcp-server@latest"]
    }
  }
}
Install in Windsurf

Follow Windsuff MCP documentation. Use following configuration:

{
  "mcpServers": {
    "Codebase": {
      "command": "npx",
      "args": ["codebase-mcp-server@latest"]
    }
  }
}
Install in Claude Desktop

Follow the MCP install guide, use following configuration:

{
  "mcpServers": {
    "Codebase": {
      "command": "npx",
      "args": ["codebase-mcp-server@latest"]
    }
  }
}

🔧 Build

Local Development Build
# Install dependencies
npm ci

# Build TypeScript
npm run build
Docker Build
# Build Docker image
docker build -t mcp/codebase -f .

# Or with specific tag
docker build -t mcp/codebase:latest -f .

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details on our Code of conduct and the process for submitting pull requests.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.