README.md
🧠 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
🔍 **Code Review**
|
🧪 **Test Generation**
|
▶️ **Test Execution**
|
🎨 **Code Formatting**
|
📦 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
🚀 Quick Start
**Step 1: Configure Your MCP Client**
🖥️ Claude Desktop
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-mcpwith your actual path
🔧 Cline (VSCode)
Add to your MCP settings:
{
"neurodev-mcp": {
"command": "python",
"args": ["-m", "neurodev_mcp.server"]
}
}
🐍 Standalone Usage
Run the server directly:
# Using the module
python -m neurodev_mcp.server
# Or as a command (if installed)
neurodev-mcp
**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
Tools 4
analyze_codePerforms static analysis on Python code using pylint, flake8, mypy, bandit, and radon.generate_testsGenerates pytest unit tests for specified functions or classes using AST analysis.run_testsExecutes test suites with coverage reporting and performance metrics.format_codeAutomatically formats Python code using black and autopep8.Try it
→Review this Python code for issues and security vulnerabilities.
→Generate unit tests for the user authentication function in auth.py.
→Run the test suite in the tests directory and provide a coverage report.
→Format the current file to comply with PEP8 standards.