MCP ExplorerExplorer

Mcpserver Codemanagerclaude

@JManuelHaceson 10 months ago
1 MIT
FreeCommunity
AI Systems
#ai#claude-ai#genai#mcp-server#python3
A powerful MCP (Model Context Protocol) server enabling AI assistants to analyze, search, and navigate codebases with precision. This tool bridges the gap between AI and your software projects by providing comprehensive code exploration capabilities including symbol search, definition finding, import analysis, and advanced code metrics.

Overview

What is Mcpserver Codemanagerclaude

MCPServer-CodeManagerClaude is a powerful Model Context Protocol (MCP) server that enables AI assistants to analyze, search, and navigate codebases with precision. It provides comprehensive code exploration capabilities, bridging the gap between AI and software projects.

Use cases

Use cases include assisting developers in navigating complex codebases, performing code audits, analyzing code quality metrics, and facilitating code reviews by providing insights into code structure and dependencies.

How to use

To use MCPServer-CodeManagerClaude, install it using the provided installation script. Once installed, utilize core functions such as exploring projects, listing files, reading file contents, and searching for symbols or references.

Key features

Key features include advanced code search and navigation, file exploration, and code analysis capabilities. This includes symbol search, definition finding, reference finding, advanced text search, project exploration, file metrics, and import analysis.

Where to use

MCPServer-CodeManagerClaude is ideal for software development environments, particularly in projects that require extensive code exploration and analysis, such as large codebases or collaborative software development.

Content

MCP Code Server

A Model Context Protocol (MCP) server that provides advanced code exploration, search, and analysis capabilities for software projects. This server acts as a bridge between AI assistants and your codebase, enabling intelligent code navigation and understanding.

Features

🔍 Code Search & Navigation

  • Symbol Search: Find classes, functions, and imports across your codebase
  • Definition Finder: Quickly locate where symbols are defined
  • Reference Finder: Discover all references to specific symbols
  • Advanced Text Search: Search with regex support, whole word matching, and context display

📁 File Explorer

  • Project Exploration: Analyze project structure and file types
  • File Reading: Read file contents with line range selection
  • Directory Listing: Browse files and directories with filtering options
  • Code-specific Search: Search within specific file patterns

📊 Code Analysis

  • File Metrics: Analyze code complexity, function counts, and more
  • Import Analysis: Track dependencies and import relationships
  • Pattern Matching: Find specific code patterns using regex
  • Code Statistics: Get insights into your codebase structure

Installation

Install the MCP Code Server using the included installation script:

uv venv
uv sync
uv run mcp install Central_Server.py

Usage

Once installed, the server provides the following tools that can be used by AI assistants:

Core Functions

Tool Description
explore_project Initialize and explore a project directory
list_files List files in a directory with filtering options
read_file Read file contents (with line range support)
search_files Search for text within files
search_symbol Find symbols (classes, functions, imports)
find_references Locate all references to a symbol
find_definition Find where a symbol is defined
search_code_advanced Advanced search with regex and context
analyze_imports Analyze import statements and dependencies
analyze_file Get code metrics and statistics
find_code_patterns Search for specific code patterns

Architecture

The project is organized as follows:

mcp-code-server/
├── Central_Server.py      # Main MCP server implementation
├── src/
│   ├── code_analyzer/     # Code analysis utilities
│   ├── code_search/       # Code search and AST parsing
│   └── file_explorer/     # File system navigation
├── examples/              # Usage examples
└── pyproject.toml         # Project configuration

Components

  • Central_Server.py: The main server file that exposes MCP tools
  • CodeSearchEngine: Provides AST-based code search capabilities
  • FileExplorer: Handles file system operations and project exploration
  • CodeAnalyzer: Performs code analysis and pattern matching

Requirements

  • Python 3.11 or higher
  • Dependencies:
    • mcp[cli]>=1.8.0

Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For issues, questions, or contributions, please create an issue in the repository.

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers