Files
Lupul-Augmentat/docs/SETUP.md
Claude (Lupul Augmentat) 475f89af74 🐺 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
2025-10-09 06:24:58 +02:00

2.7 KiB

🚀 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

📋 PREREQUISITES

  • Node.js 18+
  • npm sau yarn
  • TypeScript 5+

🔧 INSTALARE

1. Clone și Setup Initial

cd /Projects/mcp
npm install

2. Configurare Environment

# .env (NEVER COMMIT!)
MCP_HOST=127.0.0.1
MCP_PORT=19017
MCP_LOG_LEVEL=info

3. Build

npm run build

🏃 RULARE

Development Mode

npm run dev
# Server pornește la 127.0.0.1:19017

Production Mode

npm start

🔗 CONECTARE CLAUDE

1. Configurare Claude Settings

Adaugă în claude_desktop_config.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:

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

# Unit tests
npm test

# Integration tests
npm run test:integration

# Test conexiune
curl http://127.0.0.1:19017/health

🔍 TROUBLESHOOTING

Port deja ocupat

lsof -i :19017
# Kill procesul dacă e necesar

Erori TypeScript

npm run typecheck

Logs

# Development
tail -f logs/mcp-dev.log

# Production
tail -f logs/mcp.log

🔗 LEGĂTURI


Actualizat: 25 Iulie 2025