Lupul-Augmentat/docs/ARHITECTURA.md

🏗️ ARHITECTURA 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

🎯 OVERVIEW

MCP Server pentru augmentarea capabilităților Claude cu tool-uri custom.

Configurație:

• Port: 19017
• Bind: 127.0.0.1 (doar local)
• Protocol: MCP (Model Context Protocol)
• Access extern: nginx proxy → mcp.runningwolf.com

📦 COMPONENTE PRINCIPALE

1. Core Server

// src/server.ts
class MCPServer {
  port: number = 19017
  host: string = '127.0.0.1'
  
  // Tool registry
  // Transport layer
  // Request handler
}

2. Tool System

// src/tools/
interface Tool {
  name: string
  description: string
  inputSchema: JSONSchema
  handler: ToolHandler
}

3. Transport Layer

• stdio - pentru development local
• HTTP/WebSocket - pentru producție
• Authentication - pentru securitate

🔧 TOOL-URI PLANIFICATE

1. File Operations

   • Read/Write fișiere locale
   • Watch pentru modificări
   • Batch operations

2. System Integration

   • Execute comenzi
   • Monitor procese
   • Environment variables

3. Data Processing

   • JSON/CSV parsing
   • Data transformări
   • Aggregări

4. External APIs

   • HTTP requests
   • WebSocket connections
   • API key management

🔒 SECURITATE

1. Bind doar local - 127.0.0.1:19017
2. Auth tokens pentru access
3. Rate limiting per tool
4. Audit logs pentru toate operațiile

📁 STRUCTURA PROIECT

/Projects/mcp/
├── src/
│   ├── server.ts         # Entry point
│   ├── config.ts         # Configurări (NO HARDCODE!)
│   ├── tools/            # Tool implementations
│   │   ├── index.ts
│   │   ├── file.ts
│   │   └── system.ts
│   └── transport/        # Transport layers
│       ├── stdio.ts
│       └── http.ts
├── tests/                # Unit & integration tests
├── package.json
└── tsconfig.json

🔗 LEGĂTURI

• Setup Instructions
• Available Tools
• Task History

---

Actualizat: 25 Iulie 2025