# MOIDVK
## The Ultimate DevKit

[![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)](https://github.com/moidvk/moidvk)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![MCP Server](https://img.shields.io/badge/MCP-Server-orange.svg)](https://modelcontextprotocol.io/)
[![Built with Rust](https://img.shields.io/badge/built%20with-Rust-red.svg)](https://www.rust-lang.org/)
[![Powered by Bun](https://img.shields.io/badge/powered%20by-Bun-yellow.svg)](https://bun.sh/)

> **The Ultimate DevKit** - A comprehensive Model Context Protocol (MCP) server that unifies development best practices across JavaScript/TypeScript, Rust, and Python into a single, powerful toolkit.

MOIDVK provides **27+ intelligent development tools** with security-first design, high-performance Rust core, and seamless integration with your favorite AI assistants and development environments.

## ✨ Key Features

🚀 **Multi-Language Mastery**
- **JavaScript/TypeScript**: ESLint analysis, Prettier formatting, accessibility checks
- **Rust**: Clippy analysis, rustfmt formatting, performance optimization, safety checks  
- **Python**: Ruff analysis, Black formatting, type checking, dependency scanning

🔒 **Security-First Architecture**
- Comprehensive vulnerability scanning across all languages
- Production readiness validation
- NASA JPL safety rule compliance checking
- Secure command execution with sandbox isolation

⚡ **High-Performance Core**
- Rust-powered vector operations and file search
- NAPI bindings for seamless JavaScript integration
- Local semantic embeddings for intelligent code search
- Optimized algorithms for large codebases

🧠 **Intelligent Development**
- KB-MCP bidirectional integration for enhanced workflows
- Semantic code search with contextual understanding
- Development session management across tools
- Intelligent tool routing and optimization

🛠️ **Developer Experience**
- 27+ tools in one unified MCP server
- CLI interface for standalone usage
- Comprehensive error handling and fallbacks
- Extensive documentation and examples

## 🚀 Quick Start

### Installation

```bash
# Using Bun (recommended)
bun install -g moidvk

# Using npm
npm install -g moidvk
```

### MCP Server Setup

Add MOIDVK to your MCP client configuration:

```json
{
  "mcpServers": {
    "moidvk": {
      "command": "moidvk",
      "args": ["serve"],
      "env": {}
    }
  }
}
```

### CLI Usage

```bash
# Start the MCP server
moidvk serve

# Analyze JavaScript code
echo "const x = 1;" | moidvk check-code

# Format Rust code
moidvk rust-format -f src/lib.rs

# Check production readiness
moidvk check-production -f server.js --strict

# Semantic code search
moidvk search-semantic -p /path/to/project --query "authentication logic"
```

## 🛠️ Tool Categories

### 🔍 Code Quality & Analysis
| Tool | Language | Description |
|------|----------|-------------|
| `check_code_practices` | JS/TS | ESLint analysis with pagination and filtering |
| `rust_code_practices` | Rust | Clippy analysis with configurable lint levels |
| `python_code_analyzer` | Python | Ruff-powered analysis with comprehensive rules |

### 🎨 Code Formatting
| Tool | Language | Description |
|------|----------|-------------|
| `format_code` | JS/TS/CSS/HTML/MD | Prettier formatting with project config |
| `rust_formatter` | Rust | rustfmt with configurable style options |
| `python_formatter` | Python | Black formatting with line length control |

### 🔒 Security & Safety
| Tool | Language | Description |
|------|----------|-------------|
| `scan_security_vulnerabilities` | All | Project dependency vulnerability scanning |
| `check_safety_rules` | JS/TS | NASA JPL safety-critical programming rules |
| `rust_safety_checker` | Rust | Memory safety and ownership validation |
| `python_security_scanner` | Python | Bandit-powered security analysis |

### 🚀 Production & Performance
| Tool | Language | Description |
|------|----------|-------------|
| `check_production_readiness` | JS/TS | Production deployment validation |
| `rust_production_readiness` | Rust | Production deployment best practices |
| `rust_performance_analyzer` | Rust | Performance hotspot identification |
| `python_test_analyzer` | Python | Test coverage and quality metrics |

### ♿ Accessibility & Standards
| Tool | Technology | Description |
|------|------------|-------------|
| `check_accessibility` | HTML/JSX/CSS | WCAG 2.2 compliance validation |
| `check_graphql_schema` | GraphQL | Schema validation and best practices |
| `check_graphql_query` | GraphQL | Query complexity and security analysis |
| `check_redux_patterns` | Redux | State management pattern validation |

### 🧠 Intelligent Development
| Tool | Purpose | Description |
|------|---------|-------------|
| `intelligent_development_analysis` | Workflow | Optimal tool sequence orchestration |
| `semantic_development_search` | Search | Context-aware code search with embeddings |
| `development_session_manager` | Sessions | Cross-client development session management |

## 🏗️ Architecture

### High-Performance Core
```
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   JavaScript    │    │    Rust Core     │    │   Python Tools  │
│   Tools & MCP   │◄──►│   (NAPI Bridge)  │◄──►│   Integration   │
│     Server      │    │                  │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘
         ▲                       ▲                       ▲
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Development   │    │   Vector Ops &   │    │   Security &    │
│   Intelligence  │    │   Embeddings     │    │   Validation    │
└─────────────────┘    └──────────────────┘    └─────────────────┘
```

### Integration Layer
- **KB-MCP Bidirectional Integration**: Intelligent routing between MOIDVK and KB-MCP
- **Semantic Search**: Local embeddings with cross-project intelligence
- **Session Management**: Persistent development context across tools
- **Security Sandbox**: Isolated command execution with comprehensive validation

## 📊 Performance Metrics

- **Vector Operations**: 10x faster than pure JavaScript implementations
- **File Search**: Rust-powered search across large codebases
- **Memory Usage**: Optimized with intelligent caching and cleanup
- **Tool Execution**: Sub-second response times for most operations
- **Concurrent Processing**: Up to 5 parallel tool executions

## 🔧 Configuration

### Basic Configuration (`.mcp.json`)
```json
{
  "mcpServers": {
    "moidvk": {
      "command": "moidvk",
      "args": ["serve"],
      "env": {},
      "integration": {
        "kbMcp": {
          "enabled": true,
          "intelligentRouting": true,
          "preferredTools": {
            "semanticSearch": "hybrid",
            "codeAnalysis": "moidvk",
            "securityScanning": "moidvk"
          }
        }
      }
    }
  }
}
```

### Advanced Features
- **Intelligent Routing**: Automatic tool selection based on context
- **Caching**: Result caching with configurable TTL
- **Error Handling**: Comprehensive fallback mechanisms
- **Performance Monitoring**: Built-in metrics and optimization

## 🤝 Integration Examples

### Claude Desktop
```json
{
  "mcpServers": {
    "moidvk": {
      "command": "moidvk", 
      "args": ["serve"]
    }
  }
}
```

### VS Code with MCP Extension
```json
{
  "mcp.servers": [
    {
      "name": "moidvk",
      "command": "moidvk serve"
    }
  ]
}
```

### Programmatic Usage
```javascript
import { createMCPClient } from '@modelcontextprotocol/client';

const client = createMCPClient({
  command: 'moidvk',
  args: ['serve']
});

const result = await client.callTool('check_code_practices', {
  code: 'const x = 1;',
  production: true
});
```

## 🚀 Development

### Prerequisites
- **Bun** v1.0+ (recommended) or **Node.js** v18+
- **Rust** v1.70+ (for building native components)
- **Python** v3.8+ (for Python tool integration)

### Building from Source
```bash
# Clone the repository
git clone https://github.com/moidvk/moidvk
cd moidvk

# Install dependencies
bun install

# Build Rust core
bun run build:rust

# Start development server
bun run dev
```

### Running Tests
```bash
# Run comprehensive test suite
bun test

# Test specific language tools
bun test:rust
bun test:python
bun test:javascript
```

### Project Structure
```
moidvk/
├── lib/
│   ├── tools/           # Language-specific analysis tools
│   ├── rust-core/       # High-performance Rust implementations
│   ├── security/        # Security and safety validation
│   ├── integration/     # KB-MCP and external integrations
│   └── local-ai/        # Semantic search and embeddings
├── docs/                # Comprehensive documentation
├── test/                # Test suites and examples
└── scripts/             # Build and deployment scripts
```

## 📚 Documentation

- **[Getting Started Guide](docs/user-guide/getting-started.md)** - Setup and first steps
- **[Tool Reference](docs/technical/tool-reference.md)** - Complete tool documentation
- **[Integration Guide](docs/technical/mcp-integration.md)** - MCP client integration
- **[Development Guide](docs/development/)** - Contributing and development
- **[API Documentation](docs/technical/)** - Technical specifications

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

### Development Workflow
1. Fork the repository
2. Create a feature branch
3. Make your changes with tests
4. Run the full test suite
5. Submit a pull request

### Code Standards
- All code must pass security scans
- Maintain test coverage above 80%
- Follow language-specific style guides
- Document new features and APIs

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- **[Model Context Protocol](https://modelcontextprotocol.io/)** - Foundation for tool integration
- **[Bun](https://bun.sh/)** - Fast JavaScript runtime and toolkit
- **[Rust](https://www.rust-lang.org/)** - Systems programming language for performance-critical components
- **Community Contributors** - Thanks to all who make MOIDVK better

---

<div align="center">

**Built with ❤️ by the MOIDVK team**

[Website](https://moidvk.dev) • [Documentation](docs/) • [Issues](https://github.com/moidvk/moidvk/issues) • [Discussions](https://github.com/moidvk/moidvk/discussions)

</div>