NeuroDev MCP Server

🧠 NeuroDev MCP Server

*Intelligent Code Analysis, Test Generation & Execution*

A powerful Model Context Protocol (MCP) server that supercharges your Python development workflow with AI-powered code review, intelligent test generation, and comprehensive test execution.

Features • Installation • Quick Start • Tools • Examples

---

✨ Features

<table> <tr> <td width="50%">

🔍 **Code Review**

• 6 Powerful Analyzers
  • pylint - Code quality & PEP8
  • flake8 - Style enforcement
  • mypy - Type checking
  • bandit - Security scanning
  • radon - Complexity metrics
  • AST - Custom inspections
• Real-time issue detection
• Security vulnerability scanning
• Complexity & maintainability scores

</td> <td width="50%">

🧪 **Test Generation**

• Intelligent AST Analysis
  • Auto-generate pytest tests
  • Happy path coverage
  • Edge case handling
  • Exception testing
  • Type validation tests
• Supports functions & classes
• Type-hint aware

</td> </tr> <tr> <td width="50%">

▶️ **Test Execution**

• Comprehensive Testing
  • Isolated environment
  • Coverage reporting
  • Line-by-line analysis
  • Timeout protection
• Detailed pass/fail results
• Performance metrics

</td> <td width="50%">

🎨 **Code Formatting**

• Auto-formatting
  • black - Opinionated style
  • autopep8 - PEP8 compliance
• Configurable line length
• Consistent code style
• One-command formatting

</td> </tr> </table>

---

📦 Installation

**Quick Install**

```bash

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

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

# Install the package
pip install -e .
\`\`\`

### **Verify Installation**

\`\`\`bash
# Run tests (should show 15/15 passing)
python test_installation.py

# Test the server
python -m neurodev_mcp.server
\`\`\`

<details>
<summary><b>📁 Project Structure</b> (click to expand)</summary>

\`\`\`
neurodev-mcp/
├─ neurodev_mcp/              # 📦 Main package
│   ├─ __init__.py            # Package exports
│   ├─ server.py              # MCP server entry point
│   ├─ analyzers/             # 🔍 Code analysis
│   │   ├─ __init__.py
│   │   └─ code_analyzer.py   # Multi-tool static analysis
│   ├─ generators/            # 🧪 Test generation
│   │   ├─ __init__.py
│   │   └─ test_generator.py  # AST-based test creation
│   └─ executors/             # ▶️ Test execution
│       ├─ __init__.py
│       └─ test_executor.py   # Test running & formatting
├─ pyproject.toml             # Project configuration
├─ README.md                  # This file
├─ test_installation.py       # Installation validator
├─ examples.py                # Usage examples
└─ requirements.txt           # Dependencies

</details>

---

🚀 Quick Start

**Step 1: Configure Your MCP Client**

<details open> <summary><b>🖥️ Claude Desktop</b></summary>

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "neurodev-mcp": {
      "command": "/absolute/path/to/neurodev-mcp/.venv/bin/python",
      "args": ["-m", "neurodev_mcp.server"]
    }
  }
}

💡 Tip: Replace /absolute/path/to/neurodev-mcp with your actual path

</details> <details> <summary><b>🔧 Cline (VSCode)</b></summary>

Add to your MCP settings:

{
  "neurodev-mcp": {
    "command": "python",
    "args": ["-m", "neurodev_mcp.server"]
  }
}

</details> <details> <summary><b>🐍 Standalone Usage</b></summary>

Run the server directly:

# Using the module
python -m neurodev_mcp.server

# Or as a command (if installed)
neurodev-mcp

</details>

**Step 2: Restart Your Client**

Restart Claude Desktop or reload VSCode to load the server.

**Step 3: Start Using! 🎉**

Try these commands with your AI assistant:

• "Review this Python code for issues"
• "Generate unit tests for this function"
• "Run these tests with coverage"
• "Format this code to PEP8 standards"

---

🌐 Transport Options

NeuroDev MCP supports multiple transport protocols for different use cases:

**STDIO (Default) - Local CLI**

Perfect for local development with MCP clients like Claude Desktop or Cline:

# Default STDIO transport
neurodev-mcp

# Or explicitly specify STDIO
neurodev-mcp --transport stdio

Configuration (Claude Desktop): ```json