# 🏗️ 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](../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
```typescript
// src/server.ts
class MCPServer {
  port: number = 19017
  host: string = '127.0.0.1'
  
  // Tool registry
  // Transport layer
  // Request handler
}
```

### 2. Tool System
```typescript
// 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](./SETUP.md)
- [Available Tools](./TOOLS.md)
- [Task History](./TASKS.md)

---
*Actualizat: 25 Iulie 2025*