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
115 lines
2.9 KiB
Markdown
115 lines
2.9 KiB
Markdown
# 🏗️ 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* |