- 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
94 lines
3.4 KiB
Markdown
94 lines
3.4 KiB
Markdown
# 🧠 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* |