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
152 lines
2.7 KiB
Markdown
152 lines
2.7 KiB
Markdown
# 🚀 SETUP 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)
|
|
|
|
## 📋 PREREQUISITES
|
|
|
|
- Node.js 18+
|
|
- npm sau yarn
|
|
- TypeScript 5+
|
|
|
|
## 🔧 INSTALARE
|
|
|
|
### 1. Clone și Setup Initial
|
|
|
|
```bash
|
|
cd /Projects/mcp
|
|
npm install
|
|
```
|
|
|
|
### 2. Configurare Environment
|
|
|
|
```bash
|
|
# .env (NEVER COMMIT!)
|
|
MCP_HOST=127.0.0.1
|
|
MCP_PORT=19017
|
|
MCP_LOG_LEVEL=info
|
|
```
|
|
|
|
### 3. Build
|
|
|
|
```bash
|
|
npm run build
|
|
```
|
|
|
|
## 🏃 RULARE
|
|
|
|
### Development Mode
|
|
|
|
```bash
|
|
npm run dev
|
|
# Server pornește la 127.0.0.1:19017
|
|
```
|
|
|
|
### Production Mode
|
|
|
|
```bash
|
|
npm start
|
|
```
|
|
|
|
## 🔗 CONECTARE CLAUDE
|
|
|
|
### 1. Configurare Claude Settings
|
|
|
|
Adaugă în `claude_desktop_config.json`:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"custom-mcp": {
|
|
"command": "node",
|
|
"args": ["/Projects/mcp/dist/server.js"],
|
|
"env": {
|
|
"MCP_HOST": "127.0.0.1",
|
|
"MCP_PORT": "19017"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### 2. Restart Claude Desktop
|
|
|
|
După configurare, restart aplicația Claude.
|
|
|
|
## 🌐 NGINX PROXY SETUP
|
|
|
|
Pentru access extern via `mcp.runningwolf.com`:
|
|
|
|
```nginx
|
|
server {
|
|
server_name mcp.runningwolf.com;
|
|
|
|
location / {
|
|
proxy_pass http://127.0.0.1:19017;
|
|
proxy_http_version 1.1;
|
|
proxy_set_header Upgrade $http_upgrade;
|
|
proxy_set_header Connection 'upgrade';
|
|
proxy_set_header Host $host;
|
|
proxy_cache_bypass $http_upgrade;
|
|
}
|
|
|
|
# SSL config aici
|
|
}
|
|
```
|
|
|
|
## 🧪 TESTARE
|
|
|
|
```bash
|
|
# Unit tests
|
|
npm test
|
|
|
|
# Integration tests
|
|
npm run test:integration
|
|
|
|
# Test conexiune
|
|
curl http://127.0.0.1:19017/health
|
|
```
|
|
|
|
## 🔍 TROUBLESHOOTING
|
|
|
|
### Port deja ocupat
|
|
```bash
|
|
lsof -i :19017
|
|
# Kill procesul dacă e necesar
|
|
```
|
|
|
|
### Erori TypeScript
|
|
```bash
|
|
npm run typecheck
|
|
```
|
|
|
|
### Logs
|
|
```bash
|
|
# Development
|
|
tail -f logs/mcp-dev.log
|
|
|
|
# Production
|
|
tail -f logs/mcp.log
|
|
```
|
|
|
|
## 🔗 LEGĂTURI
|
|
|
|
- [Arhitectură](./ARHITECTURA.md)
|
|
- [Tools Disponibile](./TOOLS.md)
|
|
- [Task Management](./TASKS.md)
|
|
|
|
---
|
|
*Actualizat: 25 Iulie 2025* |