# 🧠 MCP SERVER - MEMORIE ȘI CONTEXT PROIECT

## ⚡ 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

## 🎯 SCOPUL PROIECTULUI

**Obiectiv Principal:** Construirea unui server MCP (Model Context Protocol) care să augmenteze capabilitățile Claude pentru automatizări și integrări custom.

**Configurație Server:**
- **Port:** 19017 (atipic, pentru securitate)
- **Bind:** 127.0.0.1:19017 (doar local)
- **Access extern:** via nginx proxy la mcp.runningwolf.com

**Conceptul Core:** Un server extensibil care oferă tool-uri specializate pentru:
- Acces la sisteme locale și remote
- Procesare date complexe
- Integrări cu servicii externe
- Workflow-uri automatizate
- Persistență și context management

## 📁 STRUCTURA DOCUMENTAȚIEI

```
/Projects/mcp/
├── CLAUDE.md (acest fișier - entry point)
├── DEBUG_CURRENT_TASK.md → task în lucru
├── TASK_IN_STANDBY.md → task-uri în așteptare
├── docs/
│   ├── ARHITECTURA.md → design și componente
│   ├── SETUP.md → configurare și instalare
│   ├── TOOLS.md → tool-uri disponibile
│   └── TASKS.md → task-uri active și istorie
└── [alte fișiere proiect]
```

## 🔗 LEGĂTURI RAPIDE

- [Arhitectură](./docs/ARHITECTURA.md) - Structura tehnică
- [Setup](./docs/SETUP.md) - Ghid instalare
- [Tools](./docs/TOOLS.md) - Tool-uri implementate
- [Tasks](./docs/TASKS.md) - Task management
- [Debug Current](./DEBUG_CURRENT_TASK.md) - Task în lucru
- [Standby Tasks](./TASK_IN_STANDBY.md) - Task-uri în așteptare

## 📌 CONTEXT CURENT

**Data începerii:** 25 Iulie 2025
**Status:** În dezvoltare - Task 5 (Documentație)

**Conversație inițială:**
- User vrea server MCP pentru augmentarea muncii
- Discuție despre scalabilitate și flexibilitate
- Cerință: sistem documentație cu arbore conectat
- Server ascultă la 127.0.0.1:19017
- Access extern via nginx proxy: mcp.runningwolf.com

## ⚡ COMENZI RAPIDE

```bash
# Development
npm run dev       # Pornește în mod development
npm run build     # Build pentru producție
npm start         # Pornește serverul

# Testing
npm test          # Rulează testele
npm run lint      # Verifică codul
```

## 🎯 CRITERII ACCEPTANȚĂ TASK CURENT

**Task:** Creează sistem de documentație cu CLAUDE.md și structură arborescentă

**Criterii:**
1. ✅ Fișier CLAUDE.md creat cu structură clară și reguli de aur
2. ⬜ Fișiere documentație în /docs create
3. ⬜ Toate fișierele conectate prin legături
4. ⬜ Reguli de aur în TOATE fișierele
5. ⬜ Test: pornire fără context → resume complet posibil

---
*Ultima actualizare: 25 Iulie 2025*