🐺 Initial commit - Lupul Augmentat MCP Server

- MCP server cu stdio transport pentru performanță maximă - Tool-uri pentru file operations, HTTP requests, system commands - Suport NATS pentru comunicare inter-module - Configurare nginx cu API key auth și SSL - Arhitectură modulară și extensibilă 🤖 Generated with Claude Code
2025-10-09 06:24:58 +02:00
commit 475f89af74
59 changed files with 12827 additions and 0 deletions
--- a/docs/SETUP.md
+++ b/docs/SETUP.md
@@ -0,0 +1,152 @@
+# 🚀 SETUP MCP SERVER
+
+## ⚡ REGULI DE AUR (NICIODATA NU ȘTERG!)
+
+1. **NICI UN TASK NU SE CONSIDERĂ ÎNDEPLINIT** până nu se îndeplinesc criteriile de acceptanță definite
+2. **NU ÎNCEPEM UN TASK** până nu definim criteriile de acceptanță
+3. **UN SINGUR TASK ÎN LUCRU** - restul în standby
+4. **DOCUMENTAȚIA RĂMÂNE ÎN ARBORE** - toate fișierele conectate
+5. **NU LUCREZI NICIODATĂ LA ALTCEVA** decât ți s-a spus explicit
+6. **NICIODATA NU HARDCODEZ VARIABILE!**
+7. **NICIODATA NU ADAUGAM SETARI FAILOVERS** - Dacă ceva nu e bine, vrem să știm imediat
+8. **Salvez date relevante taskului curent** în DEBUG_CURRENT_TASK.md
+9. **Salvez întotdeauna ce am modificat** pentru rollback dacă e nevoie
+10. **Creez criterii de acceptanță** înainte de a testa/finaliza
+11. **Când task-uri depind de API changes** → salvez în TASK_IN_STANDBY.md
+
+[← Înapoi la CLAUDE.md](../CLAUDE.md)
+
+## 📋 PREREQUISITES
+
+- Node.js 18+ 
+- npm sau yarn
+- TypeScript 5+
+
+## 🔧 INSTALARE
+
+### 1. Clone și Setup Initial
+
+```bash
+cd /Projects/mcp
+npm install
+```
+
+### 2. Configurare Environment
+
+```bash
+# .env (NEVER COMMIT!)
+MCP_HOST=127.0.0.1
+MCP_PORT=19017
+MCP_LOG_LEVEL=info
+```
+
+### 3. Build
+
+```bash
+npm run build
+```
+
+## 🏃 RULARE
+
+### Development Mode
+
+```bash
+npm run dev
+# Server pornește la 127.0.0.1:19017
+```
+
+### Production Mode
+
+```bash
+npm start
+```
+
+## 🔗 CONECTARE CLAUDE
+
+### 1. Configurare Claude Settings
+
+Adaugă în `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "custom-mcp": {
+      "command": "node",
+      "args": ["/Projects/mcp/dist/server.js"],
+      "env": {
+        "MCP_HOST": "127.0.0.1",
+        "MCP_PORT": "19017"
+      }
+    }
+  }
+}
+```
+
+### 2. Restart Claude Desktop
+
+După configurare, restart aplicația Claude.
+
+## 🌐 NGINX PROXY SETUP
+
+Pentru access extern via `mcp.runningwolf.com`:
+
+```nginx
+server {
+    server_name mcp.runningwolf.com;
+    
+    location / {
+        proxy_pass http://127.0.0.1:19017;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_cache_bypass $http_upgrade;
+    }
+    
+    # SSL config aici
+}
+```
+
+## 🧪 TESTARE
+
+```bash
+# Unit tests
+npm test
+
+# Integration tests
+npm run test:integration
+
+# Test conexiune
+curl http://127.0.0.1:19017/health
+```
+
+## 🔍 TROUBLESHOOTING
+
+### Port deja ocupat
+```bash
+lsof -i :19017
+# Kill procesul dacă e necesar
+```
+
+### Erori TypeScript
+```bash
+npm run typecheck
+```
+
+### Logs
+```bash
+# Development
+tail -f logs/mcp-dev.log
+
+# Production
+tail -f logs/mcp.log
+```
+
+## 🔗 LEGĂTURI
+
+- [Arhitectură](./ARHITECTURA.md)
+- [Tools Disponibile](./TOOLS.md)
+- [Task Management](./TASKS.md)
+
+---
+*Actualizat: 25 Iulie 2025*