NeuroDev

Provides AI-powered code review, auto test generation, and test execution for Python projects via MCP clients.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months 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": {
    "ravikant1918-neurodev-mcp": {
      "command": "python",
      "args": [
        "-m",
        "neurodev_mcp.server"
      ]
    }
  }
}

You can run NeuroDev MCP Server to enable AI-powered code review, automatic test generation, and test execution for your Python projects. It integrates with MCP clients to provide real-time analysis, smart test creation, and streamlined formatting, improving code quality and development speed.

How to use

Operate NeuroDev MCP Server by connecting it to your MCP client of choice. You’ll use the server to review Python code, generate tests from AST analysis, execute tests with coverage, and format code to meet PEP8 standards. Practical workflows include reviewing code as you type, generating and running tests for new functions, and automatically formatting code before commits. You can switch between local CLI clients and web integrations depending on your setup.

How to install

Follow these steps to install and run the server locally.

# Clone the repository
git clone https://github.com/ravikant1918/neurodev-mcp.git
cd neurodev-mcp

# Create a virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate

# Install the package in editable mode
pip install -e .

Additional setup and notes

Once installed, you can run the server in STDIO mode for local client usage or run it with a transport option such as SSE for web integrations. The server can be started directly from the Python module or via an installed command depending on your environment.

The server supports multiple transports. STDIO is ideal for desktop clients, while SSE enables web-based streaming. Ensure your MCP client is configured to load the NeuroDev MCP Server and point to the appropriate startup command for your environment.

Security and troubleshooting notes

If you encounter issues, verify that the Python executable path and project path are correct, restart your MCP client completely, and review server logs for errors. Some analyzers may be slow on large files; consider targeting specific analyzers or increasing timeouts for large test suites.

Available tools

code_review

Comprehensive code analysis using multiple static analysis tools to report style, quality, and security issues.

generate_tests

AST-based generation of pytest tests covering happy paths, edge cases, and exceptions.

run_tests

Execute tests with coverage reporting and detailed results.

format_code

Auto-format Python code to conform to PEP8 standards using Black and autopep8.