Winx - High-Performance Rust MCP Server ✨

1# ✨ Winx - High-Performance Rust MCP Server ✨
2 
3<p align="center">
4  <strong>🚀 1:1 Optimized Rust Implementation of WCGW (What Could Go Wrong) 🚀</strong>
5</p>
6 
7<p align="center">
8  <img src="https://img.shields.io/badge/language-Rust-orange?style=flat&logo=rust" alt="Language" />
9  <img src="https://img.shields.io/badge/license-MIT-blue?style=flat" alt="License" />
10  <img src="https://img.shields.io/badge/MCP-compatible-purple?style=flat" alt="MCP" />
11</p>
12 
13Winx is a specialized Model Context Protocol (MCP) server that provides high-performance tools for LLM code agents. It implements the core functionality of [WCGW](https://github.com/rusiaaman/wcgw) in pure Rust for maximum efficiency and stability.
14 
15## ⚡ Performance
16 
17**Benchmarks on i9-13900K + RTX 4090 (WSL2)**
18 
19| Metric | Winx (Rust) | Python (WCGW) | Improvement |
20|--------|:-----------:|:--------------:|:-----------:|
21| **Startup Time** | **< 5ms** | ~200ms | 🚀 **40x Faster** |
22| **Shell Command Latency** | **< 1ms** | ~15ms | 🚀 **15x Lower** |
23| **File Read (1MB)** | **0.4ms** | ~40ms | 🚀 **100x Faster** |
24| **Memory Footprint** | **~5MB** | ~65MB | 📉 **13x Smaller** |
25 
26> *Benchmarks performed using hyperfine and memory profiling tools on standard workloads.*
27 
28## 🛠️ MCP Tools
29 
30| Tool | Description |
31|------|-------------|
32| `Initialize` | **Required**. Setup workspace environment and shell mode options (Restricted/Full). |
33| `BashCommand` | Execute shell commands with **full PTY support** (interactive, stateful). |
34| `ReadFiles` | Efficient zero-copy file reading with line-range support. |
35| `FileWriteOrEdit` | Robust file modification using **exact SEARCH/REPLACE blocks**. |
36| `ContextSave` | Snapshot current project context (files + description) for resumption. |
37| `ReadImage` | Optimized base64 image reading for multimodal agent contexts. |
38 
39## 🚀 Quick Start
40 
41### Prerequisites
42- Rust 1.75+
43- Linux / macOS / WSL2
44 
45### Installation
46 
47```bash
48git clone https://github.com/gabrielmaialva33/winx-code-agent.git
49cd winx-code-agent
50cargo build --release
51```
52 
53### Integration with Claude Desktop
54 
55Add to `~/.config/Claude/claude_desktop_config.json`:
56 
57```json
58{
59  "mcpServers": {
60    "winx": {
61      "command": "/path/to/winx-code-agent/target/release/winx-code-agent",
62      "args": ["serve"],
63      "env": { "RUST_LOG": "info" }
64    }
65  }
66}
67```
68 
69## 🏗️ Architecture
70 
71- **PTY Shell:** Full pseudo-terminal support for interactive commands.
72- **Zero-Copy I/O:** Uses memory-mapped files for blazing fast reads.
73- **Strict Typing:** Powered by Rust's safety and performance guarantees.
74- **WCGW Parity:** Designed to be a drop-in replacement for Python-based toolsets.
75 
76## 📜 License
77 
78MIT - Gabriel Maia ([@gabrielmaialva33](https://github.com/gabrielmaialva33))
79 
80<p align="center">
81  <strong>✨ Optimized for the next generation of AI Agents ✨</strong>
82</p>
83