# 🔧 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*