🐺 Initial commit - Lupul Augmentat MCP Server
- 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
This commit is contained in:
115
docs/ARHITECTURA.md
Normal file
115
docs/ARHITECTURA.md
Normal file
@@ -0,0 +1,115 @@
|
||||
# 🏗️ 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*
|
||||
Reference in New Issue
Block a user