Project Explorer

Model Context Protocol server providing advanced file system operations, regex search, import/export analysis, and npm dependency management.

typescript

1

GitHub Stars

typescript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mausrundung-mcp-explorer": {
      "command": "npx",
      "args": [
        "-y",
        "@team-jd/mcp-project-explorer",
        "/path/to/project"
      ],
      "env": {
        "YOUR_ENV_VAR": "VALUE"
      }
    }
  }
}

You can run and connect to the Project Explorer MCP Server to analyze, search, and manage your project files with intelligent navigation and file operations. This server helps you explore project structure, locate code across large bases, inspect imports, and keep dependencies in check—all through a consistent MCP workflow.

How to use

You interact with the Project Explorer MCP Server through an MCP client by configuring a server entry and then issuing MCP requests to perform project analysis, advanced search, and maintenance tasks. Use it to explore directory structures, run targeted searches across code files, and verify dependency status. You can run searches, inspect file details, and perform safe file operations within allowed directories.

How to install

Prerequisites: install Node.js and npm on your workstation.

Step 1: Ensure you have Node.js and npm installed.

Step 2: Add the Project Explorer MCP Server to your MCP configuration. Include a stdio-based MCP entry that uses npx to run the MCP tool with your target project path. The example below runs the explorer against a single project path.

{
  "mcpServers": {
    "project-explorer": {
      "command": "npx",
      "args": ["-y", "@team-jd/mcp-project-explorer", "/path/to/your/project"]
    }
  }
}

Step 3: If you want to access multiple projects, you can extend the arguments with additional paths. Each path should be added to the args array.

{
  "mcpServers": {
    "project-explorer": {
      "command": "npx",
      "args": [
        "-y",
        "@team-jd/mcp-project-explorer",
        "/path/to/project1",
        "/path/to/project2",
        "/path/to/project3"
      ]
    }
  }
}

Additional sections

Security: the server operates within allowed directories only, with sandboxed access and protections against unsafe operations. All paths are validated and normalized to prevent accidental access beyond permitted locations.

Project-specific actions and examples

Several core capabilities are exposed by the Project Explorer MCP Server. You can analyze a project, search code with rich filters, check for outdated npm packages, and safely delete or rename files when needed. Use these tools to streamline project knowledge and codebase maintenance.

Available tools

explore_project

Analyzes project structure, file details, and import/export analysis with recursive traversal and optional subdirectory focus.

search_files

Performs advanced text and code searches with filters for extensions, exclusions, case sensitivity, regex, and output formatting.

check_outdated

Checks for outdated npm packages within a project and provides detailed, summary, or raw outputs.

delete_file

Safely delete files or directories with protective checks and optional recursive/force options.

rename_file

Rename or move files and directories while ensuring destinations do not already exist.

list_allowed_directories

Shows which directories the MCP server is permitted to access.