🐺 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/TOOLS.md
+++ b/docs/TOOLS.md
@@ -0,0 +1,139 @@
+# 🔧 MCP SERVER TOOLS
+
+## ⚡ 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)
+
+## 📋 TOOL-URI DISPONIBILE
+
+### ✅ Tool-uri Implementate
+
+Serverul MCP vine cu un set complet de tool-uri built-in pentru operații comune:
+
+#### 📁 [File Operations](./tools/file-operations.md)
+- **file_read** - Citire fișiere cu limite de securitate
+- **file_write** - Scriere fișiere cu validare
+- **file_list** - Listare directoare cu filtrare
+
+#### 💻 [System Command](./tools/system-command.md)
+- **system_command** - Execuție comenzi sistem (whitelist)
+
+#### 🌐 [HTTP Request](./tools/http-request.md)
+- **http_request** - Request-uri HTTP/HTTPS cu securitate
+
+📚 **[Vezi documentația completă a tool-urilor →](./tools/README.md)**
+
+## 🎯 TOOL-URI PLANIFICATE
+
+### 1. File Operations
+**Nume:** `file_read`, `file_write`, `file_watch`
+**Scop:** Operații cu fișiere locale
+**Input Schema:**
+```json
+{
+  "path": "string",
+  "encoding": "utf8|binary",
+  "content": "string (pentru write)"
+}
+```
+
+### 2. System Commands
+**Nume:** `exec_command`
+**Scop:** Execuție comenzi sistem
+**Input Schema:**
+```json
+{
+  "command": "string",
+  "args": ["array", "of", "strings"],
+  "cwd": "string",
+  "timeout": "number"
+}
+```
+
+### 3. HTTP Client
+**Nume:** `http_request`
+**Scop:** Request-uri HTTP/HTTPS
+**Input Schema:**
+```json
+{
+  "url": "string",
+  "method": "GET|POST|PUT|DELETE",
+  "headers": {},
+  "body": "string|object"
+}
+```
+
+### 4. Database Query
+**Nume:** `db_query`
+**Scop:** Interogări bază de date
+**Input Schema:**
+```json
+{
+  "connection": "string",
+  "query": "string",
+  "params": []
+}
+```
+
+### 5. Data Transform
+**Nume:** `transform_data`
+**Scop:** Transformări JSON/CSV
+**Input Schema:**
+```json
+{
+  "input": "object|array",
+  "transform": "jq expression or custom",
+  "output_format": "json|csv|yaml"
+}
+```
+
+## 🔨 CUM SĂ ADAUGI UN TOOL NOU
+
+1. **Creează fișier** în `src/tools/`
+2. **Implementează interfața**:
+```typescript
+export interface Tool {
+  name: string
+  description: string
+  inputSchema: JSONSchema
+  handler: (input: any) => Promise<any>
+}
+```
+
+3. **Înregistrează în** `src/tools/index.ts`
+4. **Adaugă teste** în `tests/tools/`
+5. **Documentează aici** cu exemple
+
+## 🧪 TESTARE TOOL-URI
+
+```bash
+# Test individual tool
+npm run test:tool -- file_read
+
+# Test all tools
+npm run test:tools
+
+# Integration test cu Claude
+npm run test:integration
+```
+
+## 🔗 LEGĂTURI
+
+- [Arhitectură](./ARHITECTURA.md)
+- [Setup Guide](./SETUP.md)
+- [Task Management](./TASKS.md)
+
+---
+*Actualizat: 25 Iulie 2025*