codebase-mcp-server

MyunghoBae/codebase-mcp-server

3.3

If you are the rightful owner of codebase-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Codebase MCP Server is a Model Context Protocol server designed for secure and efficient analysis of codebases.

The Codebase MCP Server is a robust solution for developers and teams looking to analyze and manage their codebases securely and efficiently. It leverages the Model Context Protocol (MCP) to provide a structured and secure environment for codebase analysis. The server restricts file operations to a predefined root directory, ensuring that sensitive data remains protected. It offers a suite of tools for efficient file management, including reading, searching, and retrieving detailed metadata about files. Additionally, the server can perform dependency analysis, traversing and analyzing dependency trees within projects to provide insights into project structure and dependencies. The server supports popular programming languages such as JavaScript, TypeScript, and CSS, making it a versatile tool for modern web development projects. With options for installation via npm or Docker, the Codebase MCP Server is accessible and easy to integrate into existing workflows, whether in local development environments or cloud-based infrastructures.

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 and CSS/CSS Preprocessors.

Usages

usage with VS Code

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

usage with Cursor

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

usage with Windsurf

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

usage with Claude Desktop

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

Tools

  1. get-project-basics

    Retrieves essential project information including package.json details, directory structure.

  2. search-config-files

    Searches for configuration files within the root directory and returns their paths.

  3. get-dependency-tree

    Traverses the dependency tree based on the given file path and root directory, and returns the traversal results.

  4. list-directory

    Lists the contents of a specified directory, distinguishing between files and directories.

  5. read-file-with-metadata

    Reads the content of a specified file and retrieves its metadata.