475f89af74
- 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
139 lines
3.3 KiB
Markdown
139 lines
3.3 KiB
Markdown
# 🔧 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* |