Lupul-Augmentat/docs/TOOLS.md

🔧 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

📋 TOOL-URI DISPONIBILE

✅ Tool-uri Implementate

Serverul MCP vine cu un set complet de tool-uri built-in pentru operații comune:

📁 File Operations

• file_read - Citire fișiere cu limite de securitate
• file_write - Scriere fișiere cu validare
• file_list - Listare directoare cu filtrare

💻 System Command

• system_command - Execuție comenzi sistem (whitelist)

🌐 HTTP Request

• http_request - Request-uri HTTP/HTTPS cu securitate

📚 Vezi documentația completă a tool-urilor →

🎯 TOOL-URI PLANIFICATE

1. File Operations

Nume: file_read, file_write, file_watch Scop: Operații cu fișiere locale Input Schema:

{
  "path": "string",
  "encoding": "utf8|binary",
  "content": "string (pentru write)"
}

2. System Commands

Nume: exec_command Scop: Execuție comenzi sistem Input Schema:

{
  "command": "string",
  "args": ["array", "of", "strings"],
  "cwd": "string",
  "timeout": "number"
}

3. HTTP Client

Nume: http_request Scop: Request-uri HTTP/HTTPS Input Schema:

{
  "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:

{
  "connection": "string",
  "query": "string",
  "params": []
}

5. Data Transform

Nume: transform_data Scop: Transformări JSON/CSV Input Schema:

{
  "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:

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

# 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ă
• Setup Guide
• Task Management

---

Actualizat: 25 Iulie 2025