- 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
2.7 KiB
2.7 KiB
🚀 SETUP MCP SERVER
⚡ REGULI DE AUR (NICIODATA NU ȘTERG!)
- NICI UN TASK NU SE CONSIDERĂ ÎNDEPLINIT până nu se îndeplinesc criteriile de acceptanță definite
- NU ÎNCEPEM UN TASK până nu definim criteriile de acceptanță
- UN SINGUR TASK ÎN LUCRU - restul în standby
- DOCUMENTAȚIA RĂMÂNE ÎN ARBORE - toate fișierele conectate
- NU LUCREZI NICIODATĂ LA ALTCEVA decât ți s-a spus explicit
- NICIODATA NU HARDCODEZ VARIABILE!
- NICIODATA NU ADAUGAM SETARI FAILOVERS - Dacă ceva nu e bine, vrem să știm imediat
- Salvez date relevante taskului curent în DEBUG_CURRENT_TASK.md
- Salvez întotdeauna ce am modificat pentru rollback dacă e nevoie
- Creez criterii de acceptanță înainte de a testa/finaliza
- Când task-uri depind de API changes → salvez în TASK_IN_STANDBY.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