nexus-mcp-server

fabriziosalmi/nexus-mcp-server

3.2

If you are the rightful owner of nexus-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Nexus MCP Server is a modular and configurable server designed to integrate a wide range of custom tools, making them accessible to a Large Language Model (LLM).

Tools
10
Resources
0
Prompts
0

๐Ÿš€ Nexus MCP Server

Nexus รจ un server MCP (Model Context Protocol) avanzato, modulare e configurabile che funge da hub centrale per integrare una vasta gamma di strumenti personalizzati, rendendoli disponibili a un Large Language Model (LLM).

๐Ÿ“Š Panoramica Tool e Funzioni

๐Ÿ› ๏ธ Tool Disponibili: 45
โš™๏ธ Funzioni Totali: 225+

๐Ÿ“‹ Tabella Completa Tool

ToolFileFunzioniDescrizione
API Testing Toolsapi_testing_tools.py4Testing e documentazione API REST
Archive Toolsarchive_tools.py4Gestione archivi ZIP, TAR, 7Z
Audio Processingaudio_processing.py6Elaborazione e analisi di file audio
Backup Toolsbackup_tools.py5Gestione backup e archivi avanzata
Calculatorcalculator.py2Operazioni matematiche di base
Cloud Toolscloud_tools.py10Servizi e API per piattaforme cloud
Code Analysis Toolscode_analysis_tools.py4Analisi qualitร  e metriche del codice
Code Execution Toolscode_execution_tools.py7Ambienti sicuri per esecuzione codice + Dynamic Tools
Code Generation Toolscode_generation_tools.py5Generazione template e strutture codice
Color Toolscolor_tools.py4Conversione e analisi colori
Crypto Toolscrypto_tools.py3Funzioni crittografiche e hashing
Data Analysisdata_analysis.py5Elaborazione e analisi statistica dati
Database Toolsdatabase_tools.py5Gestione database e query
Datetime Toolsdatetime_tools.py4Manipolazione date e orari
Docker Toolsdocker_tools.py6Gestione container Docker
Email Toolsemail_tools.py4Validazione email e template
Encoding Toolsencoding_tools.py6Codifica e decodifica dati
Environment Toolsenvironment_tools.py5Gestione variabili ambiente
File Converterfile_converter.py8Utilitร  conversione formati file
Filesystem Readerfilesystem_reader.py1Accesso sicuro al file system
Git Toolsgit_tools.py5Gestione repository Git
Image Processingimage_processing.py6Manipolazione e analisi immagini
JSON/YAML Toolsjson_yaml_tools.py5Manipolazione JSON e YAML
Log Analysis Toolslog_analysis_tools.py5Parsing e analisi file log
Markdown Toolsmarkdown_tools.py4Elaborazione documenti Markdown
Network Security Toolsnetwork_security_tools.py5Scansione sicurezza di rete
Network Toolsnetwork_tools.py7Diagnostica e utilitร  di rete
PDF Toolspdf_tools.py6Elaborazione documenti PDF
Performance Toolsperformance_tools.py6Monitoraggio performance sistema
Process Management Toolsprocess_management_tools.py6Controllo e monitoraggio processi
QR Code Toolsqr_code_tools.py7Generazione e analisi QR code
Regex Toolsregex_tools.py8Utilitร  espressioni regolari
Security Toolssecurity_tools.py7Utilitร  sicurezza e crittografia
String Toolsstring_tools.py5Funzioni manipolazione stringhe
System Infosystem_info.py6Informazioni e monitoraggio sistema
Template Toolstemplate_tools.py3Generazione template codice/config
Text Analysis Toolstext_analysis_tools.py4Analisi sentimenti e linguistica
Unit Converterunit_converter.py6Utilitร  conversione unitร  misura
URL Toolsurl_tools.py4Manipolazione e validazione URL
UUID Toolsuuid_tools.py6Generazione UUID e ID
Validator Toolsvalidator_tools.py5Funzioni validazione dati
Video Processingvideo_processing.py5Elaborazione file video
Weather Toolsweather_tools.py3Informazioni meteorologiche
Web Fetcherweb_fetcher.py1Recupero contenuti web
Workflow Orchestrationworkflows.py1Meta-tool per orchestrazione workflow complessi

๐ŸŽฏ Filosofia di Progettazione

  • ๐ŸŽญ Orchestrazione Centrale, Logica Distribuita: Il server principale non contiene la logica di nessun tool, ma solo la responsabilitร  di caricarli e servirli
  • โš™๏ธ Configurazione-Driven: Attivazione/disattivazione dei tool tramite file config.json senza ricompilazione
  • ๐Ÿ”’ Sicurezza First-Class: Ogni tool implementa rigorosi controlli di sicurezza
  • ๐Ÿ“š Auto-documentazione: Codice completamente documentato per facilitร  di manutenzione
  • ๐Ÿ”„ Workflow Orchestration: Meta-tool per catene di operazioni complesse con un'unica chiamata
  • ๐Ÿš€ Dynamic Tool Creation: Generazione runtime di tool personalizzati per esigenze specifiche

๐Ÿ“ฆ Tool Disponibili

๐Ÿงฎ Calculator (calculator.py)

Operazioni matematiche di base

  • add(a, b) - Addizione
  • multiply(a, b) - Moltiplicazione

๐Ÿ“ Filesystem Reader (filesystem_reader.py)

Lettura sicura di file con sandbox

  • read_safe_file(filename) - Legge file dalla directory sandbox safe_files/
  • โœ… Protezione contro path traversal
  • โœ… Validazione percorsi

๐ŸŒ Web Fetcher (web_fetcher.py)

Recupero contenuti web

  • fetch_url_content(url) - Scarica contenuto HTML da URL
  • โœ… Timeout configurabile
  • โœ… Limitazione dimensioni
  • โœ… Gestione redirect

๐Ÿ” Crypto Tools (crypto_tools.py)

Strumenti crittografici e hashing

  • generate_hash(text, algorithm) - Hash SHA256, SHA1, MD5, SHA512
  • generate_hmac(message, secret_key, algorithm) - HMAC per autenticazione
  • generate_random_token(length, encoding) - Token sicuri (hex/base64/urlsafe)

๐Ÿ”ค Encoding Tools (encoding_tools.py)

Codifica e decodifica dati

  • base64_encode(text) / base64_decode(encoded_text) - Codifica Base64
  • url_encode(text) / url_decode(encoded_text) - URL encoding/decoding
  • html_escape(text) - Escape caratteri HTML
  • json_format(json_string, indent) - Formattazione e validazione JSON

๐Ÿ“… DateTime Tools (datetime_tools.py)

Manipolazione date e timestamp

  • current_timestamp() - Timestamp corrente in vari formati
  • unix_to_date(timestamp) - Converte Unix timestamp in data
  • date_to_unix(date_string) - Converte data in Unix timestamp
  • date_math(start_date, operation, amount, unit) - Operazioni matematiche su date

๐Ÿ†” UUID Tools (uuid_tools.py)

Generazione identificatori unici

  • generate_uuid4() / generate_uuid1() - UUID versioni 1 e 4
  • generate_multiple_uuids(count, version) - Generazione multipla UUID
  • generate_short_id(length, use_uppercase) - ID brevi alfanumerici
  • generate_nanoid(length, alphabet) - Nano ID personalizzabili
  • uuid_info(uuid_string) - Analisi e informazioni UUID

๐Ÿ“ String Tools (string_tools.py)

Manipolazione avanzata stringhe

  • string_case_convert(text, case_type) - Conversioni case (camel, snake, kebab, etc.)
  • string_stats(text) - Statistiche dettagliate stringa
  • string_clean(text, operation) - Pulizia e normalizzazione testo
  • string_wrap(text, width, break_long_words) - Word wrapping
  • string_find_replace(text, find, replace, case_sensitive) - Trova e sostituisci

โœ… Validator Tools (validator_tools.py)

Validazione dati e formati

  • validate_email(email) - Validazione indirizzi email
  • validate_url(url) - Validazione e analisi URL
  • validate_ip_address(ip) - Validazione IP (IPv4/IPv6)
  • validate_phone(phone, country_code) - Validazione numeri telefono
  • validate_credit_card(card_number) - Validazione carte credito (algoritmo Luhn)

๐Ÿ’ป System Info (system_info.py)

Informazioni sistema e monitoraggio

  • system_overview() - Panoramica completa sistema
  • memory_usage() - Utilizzo RAM e SWAP
  • cpu_info() - Informazioni CPU e utilizzo
  • disk_usage(path) - Utilizzo spazio disco
  • network_info() - Informazioni interfacce di rete
  • running_processes(limit) - Top processi per utilizzo CPU

๐ŸŒ Network Tools (network_tools.py)

Strumenti diagnostici di rete

  • ping_host(host, count) - Ping verso host specificato
  • dns_lookup(hostname, record_type) - Lookup DNS (A, AAAA, MX, NS, TXT)
  • port_scan(host, ports) - Scansione porte specifiche
  • traceroute(host, max_hops) - Traceroute verso destinazione
  • whois_lookup(domain) - Informazioni whois dominio
  • check_website_status(url, timeout) - Status e performance sito web
  • get_public_ip() - IP pubblico corrente

๐Ÿ”’ Security Tools (security_tools.py)

Strumenti sicurezza e crittografia

  • generate_secure_password(length, include_symbols, exclude_ambiguous) - Password sicure
  • password_strength_check(password) - Analisi robustezza password
  • generate_api_key(length, format_type) - Chiavi API sicure
  • hash_file_content(content, algorithms) - Hash per verifica integritร 
  • jwt_decode_header(jwt_token) - Decodifica header JWT (senza verifica)
  • check_common_ports(host) - Controllo porte comuni per sicurezza
  • ssl_certificate_check(domain, port) - Verifica certificati SSL/TLS

๐Ÿ›ก๏ธ Network Security Tools (network_security_tools.py)

Strumenti avanzati di sicurezza di rete

  • ip_threat_intelligence(ip_address) - Analisi threat intelligence per indirizzi IP
  • scan_security_headers(url, follow_redirects) - Scansione header di sicurezza HTTP
  • discover_subdomains(domain, wordlist_size) - Scoperta sottodomini per security assessment
  • grab_service_banner(host, port, timeout) - Estrazione banner servizi per fingerprinting
  • analyze_certificate_chain(domain, port) - Analisi approfondita catena certificati SSL

โšก Performance Tools (performance_tools.py)

Monitoraggio e benchmark performance

  • benchmark_function_performance(code, iterations) - Benchmark codice Python
  • monitor_system_performance(duration_seconds) - Monitoraggio sistema real-time
  • analyze_memory_usage() - Analisi dettagliata memoria
  • disk_performance_test(test_size_mb) - Test velocitร  disco
  • network_latency_test(hosts) - Test latenza rete
  • cpu_stress_test(duration_seconds) - Stress test CPU

๐Ÿ“Š Data Analysis Tools (data_analysis.py)

Analisi e elaborazione dati

  • analyze_csv_data(csv_content, delimiter) - Analisi statistiche CSV
  • analyze_json_structure(json_content) - Analisi struttura JSON
  • statistical_analysis(numbers) - Statistiche descrittive complete
  • text_analysis(text) - Analisi linguistica e sentiment
  • correlation_analysis(dataset1, dataset2) - Correlazione tra dataset

๐Ÿ–ผ๏ธ Image Processing Tools (image_processing.py)

Elaborazione e analisi immagini

  • analyze_image_metadata(image_base64) - Metadata ed EXIF
  • resize_image(image_base64, width, height, maintain_aspect) - Ridimensionamento
  • convert_image_format(image_base64, target_format) - Conversione formato
  • apply_image_filters(image_base64, filters) - Filtri (blur, sharpen, sepia, etc.)
  • create_thumbnail(image_base64, size, quality) - Generazione thumbnail
  • extract_dominant_colors(image_base64, num_colors) - Palette colori dominanti

๐ŸŽต Audio Processing Tools (audio_processing.py)

Elaborazione e analisi audio

  • analyze_audio_metadata(audio_base64) - Metadata audio WAV
  • generate_sine_wave(frequency, duration, sample_rate, amplitude) - Generazione onde sinusoidali
  • analyze_audio_spectrum(audio_base64, fft_size) - Analisi spettro di frequenza
  • adjust_audio_volume(audio_base64, volume_factor) - Regolazione volume
  • convert_audio_format(audio_base64, target_format, quality) - Conversione formato
  • extract_audio_features(audio_base64) - Estrazione caratteristiche audio

๐ŸŽฌ Video Processing Tools (video_processing.py)

Elaborazione e analisi video

  • analyze_video_metadata(video_base64) - Metadata e formato video
  • create_video_thumbnail_placeholder(width, height, color, text) - Placeholder thumbnail
  • analyze_video_structure(video_base64) - Struttura MP4 (atom/box analysis)
  • estimate_video_properties(video_base64) - Stima proprietร  da euristica
  • create_video_info_summary(video_base64) - Riassunto completo informazioni

๐Ÿ”„ Unit Converter Tools (unit_converter.py)

Conversioni unitร  di misura

  • convert_length(value, from_unit, to_unit) - Conversioni lunghezza (mm, cm, m, km, in, ft, yd, mi)
  • convert_weight(value, from_unit, to_unit) - Conversioni peso (mg, g, kg, t, oz, lb, st)
  • convert_temperature(value, from_unit, to_unit) - Conversioni temperatura (C, F, K, R)
  • convert_volume(value, from_unit, to_unit) - Conversioni volume (ml, l, gal, qt, pt, cup, floz)
  • convert_area(value, from_unit, to_unit) - Conversioni area (mm2, cm2, m2, km2, in2, ft2, yd2, ac, ha)
  • list_available_units() - Elenca tutte le unitร  disponibili per categoria

๐Ÿ“ฑ QR Code Tools (qr_code_tools.py)

Generazione e analisi QR code

  • generate_qr_code(text, size, border, error_correction) - Genera QR code da testo
  • generate_qr_code_url(url, size) - Genera QR code per URL
  • generate_qr_code_wifi(ssid, password, security, hidden) - QR code configurazione WiFi
  • generate_qr_code_contact(name, phone, email, organization) - QR code contatto vCard
  • generate_qr_code_sms(phone, message) - QR code per SMS
  • analyze_qr_content(content) - Analizza tipo e contenuto QR code
  • qr_code_formats_info() - Informazioni formati QR supportati

๐Ÿ” Regex Tools (regex_tools.py)

Strumenti espressioni regolari

  • regex_test(pattern, text, flags) - Testa pattern regex su testo
  • regex_match_details(pattern, text, flags) - Dettagli corrispondenze con posizioni
  • regex_replace(pattern, text, replacement, flags, count) - Sostituisce con regex
  • regex_split(pattern, text, flags, maxsplit) - Divide testo con regex
  • regex_validate_pattern(pattern) - Valida e analizza pattern regex
  • regex_common_patterns() - Libreria pattern regex comuni
  • regex_extract_emails(text) - Estrae indirizzi email da testo
  • regex_extract_urls(text) - Estrae URL da testo

๐Ÿ”„ File Converter Tools (file_converter.py)

Conversioni formato file

  • csv_to_json(csv_content, delimiter, has_header) - Converte CSV in JSON
  • json_to_csv(json_content, delimiter, include_header) - Converte JSON in CSV
  • json_to_xml(json_content, root_name) - Converte JSON in XML
  • xml_to_json(xml_content) - Converte XML in JSON
  • txt_to_json_lines(text_content, line_key) - Converte testo in JSON righe
  • json_lines_to_txt(json_content, line_field) - Converte JSON in testo
  • detect_file_format(content) - Rileva automaticamente formato file
  • conversion_help() - Guida completa conversioni disponibili

๐Ÿ“„ PDF Tools (pdf_tools.py)

Strumenti elaborazione PDF

  • analyze_pdf_metadata(pdf_base64) - Analizza metadata e struttura PDF
  • create_simple_pdf_info(title, author, subject, pages) - Genera informazioni PDF
  • pdf_text_extraction_guide() - Guida estrazione testo da PDF
  • validate_pdf_structure(pdf_base64) - Valida struttura PDF
  • pdf_security_check(pdf_base64) - Controlla impostazioni sicurezza PDF
  • pdf_tools_info() - Documentazione completa strumenti PDF

โ˜๏ธ Cloud Platform Tools (cloud_tools.py)

Strumenti per servizi cloud e multi-cloud

  • aws_service_status(service, region) - Verifica stato servizi AWS
  • azure_service_status(service, region) - Verifica stato servizi Azure
  • gcp_service_status(service, region) - Verifica stato servizi Google Cloud
  • cloudflare_dns_lookup(domain, record_type) - Query DNS tramite Cloudflare
  • digitalocean_status_check() - Verifica stato servizi DigitalOcean
  • cloud_cost_calculator(service_type, usage_hours, instance_type) - Calcolo costi cloud
  • cloud_health_checker(endpoints) - Controllo salute endpoint cloud
  • cloud_security_scanner(config_text, cloud_provider) - Scansione sicurezza configurazioni
  • multi_cloud_resource_tracker(resources) - Tracciamento risorse multi-cloud
  • cloud_config_validator(config_text, config_type) - Validazione file configurazione cloud

๐ŸŒฆ๏ธ Weather Tools (weather_tools.py)

Strumenti meteorologici e analisi clima

  • get_weather_info(city, country_code, units) - Informazioni meteo per cittร 
  • parse_weather_data(weather_json) - Analisi dati meteorologici JSON
  • weather_alert_formatter(temperature, humidity, wind_speed) - Generazione avvisi meteo

๐Ÿ”— URL Tools (url_tools.py)

Manipolazione e validazione URL

  • validate_url(url) - Validazione e analisi URL completa
  • url_shortener_simulator(url, custom_alias) - Simulatore accorciamento URL
  • extract_domain_info(url) - Estrazione informazioni dettagliate dominio
  • build_query_url(base_url, params) - Costruzione URL con parametri query

๐Ÿ“ Text Analysis Tools (text_analysis_tools.py)

Analisi linguistica e sentiment

  • analyze_text_sentiment(text) - Analisi sentiment con dizionario multilingue
  • word_frequency_analysis(text, top_n) - Analisi frequenza parole con stop words
  • readability_score(text) - Calcolo indici di leggibilitร  (Flesch)
  • detect_language_simple(text) - Rilevamento lingua con pattern matching

๐Ÿ“ง Email Tools (email_tools.py)

Gestione email e template

  • validate_email_advanced(email) - Validazione email con controlli RFC
  • generate_email_template(template_type, sender_name, recipient_name, subject) - Template email professionali
  • parse_email_header(email_text) - Analisi header email con controlli sicurezza
  • generate_email_signature(name, title, company, phone, email, website) - Firme email HTML/testo

๐ŸŽจ Color Tools (color_tools.py)

Conversione e analisi colori

  • convert_color_format(color, target_format) - Conversione tra HEX, RGB, HSL, HSV
  • generate_color_palette(base_color, palette_type) - Palette complementari, triadiche, analoghe
  • analyze_color_contrast(color1, color2) - Analisi contrasto WCAG per accessibilitร 
  • color_mixer(color1, color2, ratio) - Miscelazione colori con gradazioni

๐Ÿ“„ JSON/YAML Tools (json_yaml_tools.py)

Manipolazione avanzata JSON e YAML

  • validate_json_advanced(json_string) - Validazione JSON con analisi strutturale
  • convert_json_yaml(data, source_format, target_format) - Conversione bidirezionale JSON/YAML
  • json_diff_comparison(json1, json2) - Confronto JSON con differenze dettagliate
  • json_path_extractor(json_string, json_path) - Estrazione valori con path notation
  • json_minify_beautify(json_string, operation) - Minificazione/beautificazione JSON

๐Ÿš€ API Testing Tools (api_testing_tools.py)

Testing e documentazione API REST

  • build_http_request(method, url, headers, body, auth_type) - Costruzione richieste HTTP complete
  • validate_api_response(response_body, expected_status, expected_schema) - Validazione risposte API
  • generate_api_test_suite(base_url, endpoints, auth_method) - Suite test automatica con curl/Python
  • parse_api_documentation(api_spec, spec_format) - Analisi documentazione OpenAPI/Swagger/Postman

๐Ÿ“‹ Template Tools (template_tools.py)

Generazione template codice e configurazioni

  • generate_dockerfile_template(base_image, language, port, additional_packages) - Template Dockerfile per varie tecnologie
  • generate_config_template(config_type, app_name, environment) - Template configurazione (nginx, docker-compose, k8s, env)
  • generate_code_template(template_type, class_name, language, features) - Template codice (classi, API, test)

๐Ÿ“ Markdown Tools (markdown_tools.py)

Elaborazione documenti Markdown

  • markdown_to_html(markdown_text) - Conversione Markdown to HTML
  • generate_markdown_table(headers, data, alignment) - Generazione tabelle Markdown
  • analyze_markdown_structure(markdown_text) - Analisi struttura documento con statistiche
  • generate_markdown_toc(markdown_text, max_level) - Generazione indice automatico
  • format_markdown_document(title, author, content, include_metadata) - Formattazione documenti completi

๐Ÿ“ฆ Archive Tools (archive_tools.py)

Gestione archivi avanzata

  • create_zip_archive(file_list, archive_name, compression_level) - Simulazione archivi ZIP con analisi
  • analyze_archive_structure(archive_type, file_list) - Analisi struttura archivi con raccomandazioni
  • compare_archive_formats(file_types, total_size_mb) - Confronto efficienza formati archivio
  • generate_archive_script(archive_type, source_dir, archive_name, options) - Script bash/PowerShell per archiviazione

๐Ÿ”„ Workflow Orchestration (Advanced Meta-Tool) - NUOVO

๐Ÿš€ Workflow Tools (workflows.py) - RIVOLUZIONARIO

Orchestrazione Meta-Tool per workflow complessi

  • analyze_repository(url, analysis_depth) - META-TOOL: Workflow completo di analisi repository
    • Catena multiple operazioni: clone โ†’ analisi complessitร  โ†’ scan sicurezza โ†’ analisi struttura โ†’ archivio โ†’ cleanup
    • Livelli profonditร : "quick", "standard", "deep"
    • Riduce da 6+ chiamate individuali a 1 singola operazione
    • Report comprensivo con tracking workflow e gestione errori
    • Cleanup automatico risorse e gestione directory temporanee
Vantaggi Chiave
  • Riduzione Complessitร : Singola chiamata sostituisce multiple operazioni
  • Risultati Ricchi: Analisi comprensiva con reporting aggregato
  • Resilienza Errori: Gestione errori elegante con reporting dettagliato
  • Gestione Risorse: Cleanup automatico previene problemi spazio disco
  • Analisi Flessibile: Livelli configurabili per diversi casi d'uso
Struttura Output Workflow
{
  "workflow_id": "repo_analysis_20250907_094500",
  "repository_url": "https://github.com/user/repo.git",
  "final_status": "completed",
  "steps_completed": ["repository_clone", "code_complexity", "secret_detection", "structure_analysis", "cleanup"],
  "summary": {
    "code_analysis": {"files_analyzed": 25, "total_lines": 1500, "languages_detected": 3},
    "security_analysis": {"secrets_found": 0, "risk_level": "LOW"}
  },
  "duration_seconds": 2.45
}

๐ŸŒ Environment Tools (environment_tools.py) - NUOVO

Gestione variabili ambiente e configurazioni

  • manage_environment_variables(action, variables, variable_name) - Gestisce variabili d'ambiente (list, get, set, unset, validate)
  • create_environment_file(env_type, variables, file_path) - Crea file configurazione (.env, .ini, .json, .yaml)
  • analyze_system_environment() - Analizza ambiente sistema con diagnostica completa
  • backup_restore_environment(action, backup_path, variables) - Backup/ripristino configurazioni ambiente
  • validate_configuration_file(file_path, config_type) - Valida file configurazione comuni

๐Ÿ“Š Log Analysis Tools (log_analysis_tools.py) - NUOVO

Parsing e analisi file log avanzata

  • parse_log_file(file_path, log_format, max_lines) - Parsing log con formati multipli (apache, nginx, syslog, json)
  • analyze_log_patterns(log_data, pattern_type) - Analizza pattern specifici (errors, requests, performance, security)
  • generate_log_report(log_data, report_type) - Genera report comprensivi (summary, detailed, timeline, alerts)
  • filter_log_entries(log_data, filters) - Filtra log per criteri specifici
  • export_log_analysis(analysis_data, export_format, file_path) - Export analisi (json, csv, html, text)

๐Ÿ’พ Backup Tools (backup_tools.py) - NUOVO

Gestione backup e archivi avanzata

  • create_archive(source_path, archive_type, include_patterns, exclude_patterns) - Crea archivi ZIP/TAR con filtri avanzati
  • extract_archive(archive_path, destination_path, verify_integrity) - Estrae archivi con verifica integritร 
  • create_backup_manifest(backup_path, source_paths, metadata) - Crea manifest di backup con checksums
  • verify_backup_integrity(manifest_path, backup_base_path) - Verifica integritร  backup usando manifest
  • compress_files(file_paths, compression_level, algorithm) - Comprime file individuali (gzip, bzip2, zip)

๐Ÿ—๏ธ Struttura del Progetto

nexus-mcp-server/
โ”œโ”€โ”€ .venv/                      # Ambiente virtuale Python
โ”œโ”€โ”€ multi_server.py             # ๐ŸŽฏ Orchestratore principale
โ”œโ”€โ”€ config.json                 # โš™๏ธ Configurazione tool
โ”œโ”€โ”€ requirements.txt            # ๐Ÿ“ฆ Dipendenze Python
โ”œโ”€โ”€ client.py                   # ๐Ÿงช Client di test
โ”œโ”€โ”€ README.md                   # ๐Ÿ“– Questa documentazione
โ”œโ”€โ”€ safe_files/                 # ๐Ÿ”’ Directory sandbox sicura
โ”‚   โ””โ”€โ”€ esempio.txt
โ””โ”€โ”€ tools/                      # ๐Ÿ› ๏ธ Moduli tool
    โ”œโ”€โ”€ __init__.py
    โ”œโ”€โ”€ calculator.py           # ๐Ÿงฎ Tool matematici
    โ”œโ”€โ”€ filesystem_reader.py    # ๐Ÿ“ Lettore file sicuro
    โ”œโ”€โ”€ web_fetcher.py          # ๐ŸŒ Recupero contenuti web
    โ”œโ”€โ”€ crypto_tools.py         # ๐Ÿ” Strumenti crittografici
    โ”œโ”€โ”€ encoding_tools.py       # ๐Ÿ”ค Codifica/decodifica
    โ”œโ”€โ”€ datetime_tools.py       # ๐Ÿ“… Manipolazione date
    โ”œโ”€โ”€ uuid_tools.py           # ๐Ÿ†” Generazione UUID/ID
    โ”œโ”€โ”€ string_tools.py         # ๐Ÿ“ Manipolazione stringhe
    โ”œโ”€โ”€ validator_tools.py      # โœ… Validazione dati
    โ”œโ”€โ”€ system_info.py          # ๐Ÿ’ป Informazioni sistema
    โ”œโ”€โ”€ network_tools.py        # ๐ŸŒ Strumenti diagnostici rete
    โ”œโ”€โ”€ security_tools.py       # ๐Ÿ”’ Strumenti sicurezza
    โ”œโ”€โ”€ network_security_tools.py # ๐Ÿ›ก๏ธ Strumenti sicurezza di rete
    โ”œโ”€โ”€ performance_tools.py    # โšก Monitoraggio performance
    โ”œโ”€โ”€ data_analysis.py        # ๐Ÿ“Š Analisi dati
    โ”œโ”€โ”€ image_processing.py     # ๐Ÿ–ผ๏ธ Elaborazione immagini
    โ”œโ”€โ”€ audio_processing.py     # ๐ŸŽต Elaborazione audio
    โ”œโ”€โ”€ video_processing.py     # ๐ŸŽฌ Elaborazione video
    โ”œโ”€โ”€ unit_converter.py       # ๐Ÿ”„ Conversioni unitร  misura
    โ”œโ”€โ”€ qr_code_tools.py        # ๐Ÿ“ฑ Generazione QR code
    โ”œโ”€โ”€ regex_tools.py          # ๐Ÿ” Strumenti regex
    โ”œโ”€โ”€ file_converter.py       # ๐Ÿ”„ Conversioni formato file
    โ”œโ”€โ”€ pdf_tools.py            # ๐Ÿ“„ Strumenti PDF
    โ”œโ”€โ”€ cloud_tools.py          # โ˜๏ธ Strumenti cloud platform
    โ”œโ”€โ”€ weather_tools.py        # ๐ŸŒฆ๏ธ Strumenti meteorologici
    โ”œโ”€โ”€ url_tools.py            # ๐Ÿ”— Manipolazione URL
    โ”œโ”€โ”€ text_analysis_tools.py  # ๐Ÿ“ Analisi testo e sentiment
    โ”œโ”€โ”€ email_tools.py          # ๐Ÿ“ง Gestione email e template
    โ”œโ”€โ”€ color_tools.py          # ๐ŸŽจ Conversione e analisi colori
    โ”œโ”€โ”€ json_yaml_tools.py      # ๐Ÿ“„ Manipolazione JSON/YAML
    โ”œโ”€โ”€ api_testing_tools.py    # ๐Ÿš€ Testing API REST
    โ”œโ”€โ”€ template_tools.py       # ๐Ÿ“‹ Generazione template
    โ”œโ”€โ”€ markdown_tools.py       # ๐Ÿ“ Elaborazione Markdown
    โ”œโ”€โ”€ archive_tools.py        # ๐Ÿ“ฆ Gestione archivi
    โ”œโ”€โ”€ code_analysis_tools.py  # ๐Ÿ” Analisi qualitร  codice
    โ”œโ”€โ”€ code_execution_tools.py # ๐Ÿš€ Esecuzione codice sicura + Dynamic Tools
    โ”œโ”€โ”€ code_generation_tools.py # ๐Ÿ—๏ธ Generazione codice e template
    โ”œโ”€โ”€ database_tools.py       # ๐Ÿ—„๏ธ Gestione database SQLite
    โ”œโ”€โ”€ docker_tools.py         # ๐Ÿณ Gestione container Docker
    โ”œโ”€โ”€ git_tools.py            # ๐Ÿ“‹ Gestione repository Git
    โ”œโ”€โ”€ process_management_tools.py # โš™๏ธ Gestione processi sistema
    โ”œโ”€โ”€ environment_tools.py    # ๐ŸŒ Gestione variabili ambiente (NUOVO)
    โ”œโ”€โ”€ backup_tools.py         # ๐Ÿ’พ Gestione backup avanzati (NUOVO)
    โ”œโ”€โ”€ log_analysis_tools.py   # ๐Ÿ“Š Analisi log avanzata (NUOVO)
    โ””โ”€โ”€ workflows.py            # ๐Ÿ”„ Orchestrazione workflow (NUOVO)

## ๐ŸŽฏ Dynamic One-Time Tools (Advanced Feature)

**Nexus** includes the revolutionary **Dynamic One-Time Tools** feature - the most advanced capability that allows LLMs to create custom tools on-the-fly for specific tasks that don't have existing solutions.

### ๐Ÿš€ `create_and_run_tool` Function

This breakthrough feature enables LLMs to write Python code for specific tasks and execute it in a completely isolated, secure environment:

```python
create_and_run_tool(python_code: str, timeout: int = 60, memory_limit_mb: int = 128)

๐Ÿ”’ Security Features

  • Docker Isolation: Complete environment isolation using Docker containers
  • Code Security Validation: Blocks dangerous operations before execution
  • Resource Limits: Memory (32-512MB), CPU (0.5 cores), Time (10-300s)
  • Network Isolation: Zero network access during execution
  • Non-root Execution: Unprivileged user execution
  • Read-only Filesystem: Limited filesystem access

๐ŸŽฏ Use Cases

  • Data Format Conversion: Convert proprietary or legacy formats
  • Mathematical Computations: Complex calculations not covered by existing tools
  • Custom Text Processing: Specific parsing and analysis requirements
  • Algorithm Implementation: One-off algorithms for unique problems
  • Long-tail Problems: Any computational task not covered by existing tools

๐Ÿ’ก Example Usage

# Convert custom timestamp format
code = """
from datetime import datetime
custom_timestamp = "20250907T143022Z"
dt = datetime.strptime(custom_timestamp, "%Y%m%dT%H%M%SZ")
print(f"ISO: {dt.isoformat()}")
print(f"Readable: {dt.strftime('%B %d, %Y at %I:%M %p')}")
"""

result = create_and_run_tool(code, timeout=30, memory_limit_mb=64)

This represents the pinnacle of agentic capabilities - true on-demand tool creation for any computational task within security constraints.

๐Ÿ“–

๐Ÿš€ Quick Start

Deployment Automatico (Raccomandato)

# Clona il progetto
git clone <repository-url> nexus-mcp-server
cd nexus-mcp-server

# Deployment completo con script automatico
./scripts/deploy.sh full

# Oppure deployment specifico:
./scripts/deploy.sh local    # Solo ambiente locale
./scripts/deploy.sh docker   # Solo Docker
./scripts/deploy.sh compose  # Docker Compose

1. Setup Ambiente Locale

# Crea ambiente virtuale
python -m venv .venv

# Attiva ambiente virtuale
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate   # Windows

# Installa dipendenze
pip install -r requirements.txt

2. Docker Setup

# Build immagine Docker
docker build -t nexus-mcp-server:latest .

# Avvia con Docker Compose
docker-compose up -d nexus-mcp

# Test container
docker run --rm -i nexus-mcp-server:latest python -c "print('OK')"

3. Utilizzo

# Locale
python client.py <nome_tool> '<argomenti_json>'

# Docker
docker run --rm -i -v "./safe_files:/app/safe_files:rw" nexus-mcp-server:latest python client.py <tool> '<args>'

3. Esempi di Utilizzo

# Calculator
python client.py add '{"a": 42, "b": 8}'
python client.py multiply '{"a": 7, "b": 6}'

# Crypto Tools
python client.py generate_hash '{"text": "Hello World", "algorithm": "sha256"}'
python client.py generate_random_token '{"length": 16, "encoding": "hex"}'

# String Tools  
python client.py string_case_convert '{"text": "Hello World", "case_type": "snake"}'
python client.py string_stats '{"text": "The quick brown fox jumps over the lazy dog"}'

# DateTime Tools
python client.py current_timestamp '{}'
python client.py date_to_unix '{"date_string": "2024-12-25 15:30:00"}'

# UUID Tools
python client.py generate_uuid4 '{}'
python client.py generate_nanoid '{"length": 12, "alphabet": "lowercase"}'

# Encoding Tools
python client.py base64_encode '{"text": "Hello, Nexus!"}'
python client.py json_format '{"json_string": "{\\"name\\":\\"test\\",\\"value\\":123}"}'

# Validator Tools
python client.py validate_email '{"email": "user@example.com"}'
python client.py validate_url '{"url": "https://www.example.com/path?query=1"}'

# System Info
python client.py system_overview '{}'
python client.py memory_usage '{}'
python client.py running_processes '{"limit": 5}'

# Filesystem Reader
python client.py read_safe_file '{"filename": "esempio.txt"}'

# Web Fetcher  
python client.py fetch_url_content '{"url": "https://httpbin.org/json"}'

# Network Tools
python client.py ping_host '{"host": "8.8.8.8", "count": 4}'
python client.py dns_lookup '{"hostname": "example.com", "record_type": "A"}'
python client.py check_website_status '{"url": "https://www.example.com"}'
python client.py get_public_ip '{}'

# Security Tools
python client.py generate_secure_password '{"length": 16, "include_symbols": true}'
python client.py password_strength_check '{"password": "MyPassword123!"}'
python client.py generate_api_key '{"length": 32, "format_type": "hex"}'

# Network Security Tools
python client.py ip_threat_intelligence '{"ip_address": "8.8.8.8"}'
python client.py scan_security_headers '{"url": "https://example.com"}'
python client.py discover_subdomains '{"domain": "example.com", "wordlist_size": "small"}'
python client.py grab_service_banner '{"host": "example.com", "port": 80}'
python client.py analyze_certificate_chain '{"domain": "example.com", "port": 443"}'

# Performance Tools
python client.py benchmark_function_performance '{"code": "sum(range(1000))", "iterations": 1000}'
python client.py monitor_system_performance '{"duration_seconds": 5}'
python client.py analyze_memory_usage '{}'

# Data Analysis Tools
python client.py statistical_analysis '{"numbers": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]}'
python client.py text_analysis '{"text": "This is a sample text for analysis."}'

# Unit Converter Tools
python client.py convert_length '{"value": 100, "from_unit": "cm", "to_unit": "m"}'
python client.py convert_temperature '{"value": 100, "from_unit": "C", "to_unit": "F"}'
python client.py convert_weight '{"value": 1000, "from_unit": "g", "to_unit": "kg"}'
python client.py list_available_units '{}'

# QR Code Tools
python client.py generate_qr_code '{"text": "Hello World", "size": 200}'
python client.py generate_qr_code_url '{"url": "https://github.com", "size": 250}'
python client.py generate_qr_code_wifi '{"ssid": "MyWiFi", "password": "password123", "security": "WPA"}'
python client.py analyze_qr_content '{"content": "https://www.example.com"}'

# Regex Tools
python client.py regex_test '{"pattern": "[0-9]+", "text": "Ho 25 anni e 30 euro"}'
python client.py regex_replace '{"pattern": "[0-9]+", "text": "Ho 25 anni", "replacement": "XXX"}'
python client.py regex_extract_emails '{"text": "Contatta mario@example.com o lucia@test.it"}'
python client.py regex_common_patterns '{}'

# File Converter Tools
python client.py csv_to_json '{"csv_content": "name,age\\nMario,30\\nLucia,25", "delimiter": ","}'
python client.py json_to_csv '{"json_content": "[{\\"name\\": \\"Mario\\", \\"age\\": 30}]"}'
python client.py detect_file_format '{"content": "{\\"test\\": \\"json\\"}"}'
python client.py conversion_help '{}'

# PDF Tools
python client.py pdf_text_extraction_guide '{}'
python client.py pdf_tools_info '{}'

# Cloud Platform Tools
python client.py aws_service_status '{"service": "all", "region": "us-east-1"}'
python client.py azure_service_status '{"service": "compute", "region": "East US"}'
python client.py gcp_service_status '{"service": "all", "region": "us-central1"}'
python client.py cloudflare_dns_lookup '{"domain": "example.com", "record_type": "A"}'
python client.py digitalocean_status_check '{}'
python client.py cloud_cost_calculator '{"service_type": "compute", "usage_hours": 730, "instance_type": "medium"}'
python client.py cloud_health_checker '{"endpoints": ["https://api.example.com", "https://status.example.com"]}'
python client.py cloud_security_scanner '{"config_text": "{\\"Action\\": \\"*\\", \\"Resource\\": \\"*\\"}", "cloud_provider": "aws"}'
python client.py multi_cloud_resource_tracker '{"resources": [{"provider": "aws", "type": "ec2", "name": "web-server", "region": "us-east-1"}]}'
python client.py cloud_config_validator '{"config_text": "{\\"AWSTemplateFormatVersion\\": \\"2010-09-09\\"}", "config_type": "json"}'

# Environment Tools (NUOVO)
python client.py manage_environment_variables '{"action": "list"}'
python client.py manage_environment_variables '{"action": "get", "variable_name": "PATH"}'
python client.py manage_environment_variables '{"action": "set", "variables": {"CUSTOM_VAR": "value123"}}'
python client.py create_environment_file '{"env_type": "env", "variables": {"DB_HOST": "localhost", "DB_PORT": "5432"}}'
python client.py analyze_system_environment '{}'
python client.py backup_restore_environment '{"action": "backup", "variables": ["PATH", "HOME", "USER"]}'
python client.py validate_configuration_file '{"file_path": "/path/to/config.json", "config_type": "json"}'

# Backup Tools (NUOVO)  
python client.py create_archive '{"source_path": "/path/to/backup", "archive_type": "zip", "exclude_patterns": ["*.tmp", "*.log"]}'
python client.py extract_archive '{"archive_path": "/path/to/archive.zip", "verify_integrity": true}'
python client.py create_backup_manifest '{"backup_path": "/backup/dir", "source_paths": ["/home/user/docs"]}'
python client.py verify_backup_integrity '{"manifest_path": "/backup/manifest.json"}'
python client.py compress_files '{"file_paths": ["/file1.txt", "/file2.txt"], "algorithm": "gzip", "compression_level": 6}'

# Log Analysis Tools (NUOVO)
python client.py parse_log_file '{"file_path": "/var/log/access.log", "log_format": "auto", "max_lines": 1000}'
python client.py analyze_log_patterns '{"log_data": [...], "pattern_type": "errors"}'
python client.py generate_log_report '{"log_data": [...], "report_type": "summary"}'
python client.py filter_log_entries '{"log_data": [...], "filters": {"level": "ERROR", "message_contains": "timeout"}}'
python client.py export_log_analysis '{"analysis_data": {...}, "export_format": "html"}'

# Workflow Orchestration (NUOVO - META-TOOL)
python client.py analyze_repository '{"url": "https://github.com/user/repo.git", "analysis_depth": "standard"}'
python client.py analyze_repository '{"url": "https://github.com/user/repo.git", "analysis_depth": "deep"}'

# Database Tools
python client.py create_sqlite_database '{"database_name": "test_db", "tables": [{"name": "users", "columns": [{"name": "id", "type": "INTEGER", "primary_key": true}, {"name": "name", "type": "TEXT"}]}]}'
python client.py validate_sql_query '{"query": "SELECT * FROM users WHERE id = 1", "database_type": "sqlite"}'
python client.py execute_safe_query '{"database_path": "/tmp/test.db", "query": "SELECT COUNT(*) FROM users"}'

# Docker Tools
python client.py check_docker_status '{}'
python client.py list_docker_containers '{"status": "running"}'
python client.py list_docker_images '{}'
python client.py validate_dockerfile '{"dockerfile_content": "FROM python:3.9\\nCOPY . /app\\nWORKDIR /app"}'

# Git Tools
python client.py analyze_git_repository '{"repo_path": "."}'
python client.py git_diff_analysis '{"file_path": "README.md", "staged": false}'
python client.py git_commit_history '{"limit": 10}'
python client.py generate_gitignore '{"language": "python", "additional_patterns": ["*.custom"]}'

# Process Management Tools
python client.py list_processes_by_criteria '{"criteria": "cpu_usage", "limit": 10}'
python client.py monitor_process '{"pid": 1234, "duration": 30}'
python client.py execute_with_limits '{"command": "echo hello", "timeout": 10, "memory_limit_mb": 50}'
python client.py analyze_system_resources '{}'

# Code Execution Tools (Dynamic Tools)
python client.py execute_python_code '{"code": "print(\\"Hello World\\")", "timeout": 30}'
python client.py create_and_run_tool '{"python_code": "import datetime\\nprint(datetime.datetime.now())", "timeout": 60}'
python client.py validate_python_syntax '{"code": "def hello(): return \\"world\\"", "strict_mode": true}'

๐Ÿ”Œ Integrazione VSCode con Docker/Docker Compose

Prerequisiti

  • VSCode con estensione Continue o Claude Code installata
  • Docker installato e funzionante
  • Docker Compose (opzionale, per deployment orchestrato)

๐Ÿ“‹ Setup VSCode - Versione Docker

1. Build dell'immagine Docker
# Assicurati di essere nella directory del progetto
cd nexus-mcp-server

# Build dell'immagine
docker build -t nexus-mcp-server:latest .

# Verifica che l'immagine sia stata creata
docker images | grep nexus-mcp-server
2. Configurazione VSCode

Crea o modifica il file di configurazione MCP in VSCode (solitamente in %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json su Windows o ~/.vscode/settings.json):

{
  "mcpServers": {
    "nexus-docker": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--network=host",
        "-v", "./safe_files:/app/safe_files:rw",
        "-v", "./config.json:/app/config.json:ro",
        "nexus-mcp-server:latest"
      ],
      "env": {
        "MCP_SERVER_NAME": "NexusServer-Docker"
      }
    }
  }
}
3. Test della configurazione
# Test rapido del container
docker run --rm -i \
  -v "$(pwd)/safe_files:/app/safe_files:rw" \
  -v "$(pwd)/config.json:/app/config.json:ro" \
  nexus-mcp-server:latest \
  python client.py system_overview '{}'

๐Ÿณ Setup VSCode - Versione Docker Compose

1. Avvio del servizio con Docker Compose
# Avvia il server in background
docker-compose up -d nexus-mcp

# Verifica che il container sia in esecuzione
docker-compose ps

# Visualizza i log (opzionale)
docker-compose logs -f nexus-mcp
2. Configurazione VSCode per Docker Compose
{
  "mcpServers": {
    "nexus-compose": {
      "command": "docker-compose",
      "args": ["exec", "-T", "nexus-mcp", "python", "multi_server.py"],
      "cwd": ".",
      "env": {
        "MCP_SERVER_NAME": "NexusServer-Compose"
      }
    }
  }
}
3. Test con Docker Compose
# Test attraverso docker-compose
docker-compose exec nexus-mcp python client.py add '{"a": 42, "b": 8}'

# Test di piรน funzioni
docker-compose exec nexus-mcp python client.py system_overview '{}'
docker-compose exec nexus-mcp python client.py generate_uuid4 '{}'

๐Ÿ“‚ Configurazioni Pre-configurate

Il progetto include file di configurazione pronti all'uso nella directory mcp-configs/:

# Copia la configurazione VSCode nel tuo ambiente
cp mcp-configs/vscode-mcp.json ~/.vscode/mcp-servers.json

# Oppure per Continue/Claude Code
cp mcp-configs/claude-code-config.json %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\

๐Ÿ”ง Configurazione Avanzata

Variabili d'ambiente personalizzate
# docker-compose.override.yml
services:
  nexus-mcp:
    environment:
      - LOG_LEVEL=DEBUG
      - MCP_SERVER_NAME=NexusServer-Dev
      - CUSTOM_CONFIG_PATH=/app/config-dev.json
    volumes:
      - ./config-dev.json:/app/config-dev.json:ro
Configurazione di rete personalizzata
# Per esporre il server su una porta specifica
services:
  nexus-mcp:
    ports:
      - "8080:9999"
    environment:
      - MCP_HTTP_PORT=9999

๐Ÿงช Testing e Verifica

1. Test di connettivitร 
# Test Docker diretto
docker run --rm nexus-mcp-server:latest python -c "print('โœ… Container funzionante')"

# Test Docker Compose
docker-compose exec nexus-mcp python -c "print('โœ… Compose funzionante')"
2. Test funzionalitร  MCP
# Test tool matematici
docker-compose exec nexus-mcp python client.py add '{"a": 10, "b": 5}'

# Test tool di sicurezza
docker-compose exec nexus-mcp python client.py generate_secure_password '{"length": 16}'

# Test tool di sistema
docker-compose exec nexus-mcp python client.py memory_usage '{}'
3. Verifica integrazione VSCode
  1. Riavvia VSCode dopo aver configurato il server MCP
  2. Apri la palette comandi (Ctrl+Shift+P)
  3. Cerca "MCP" o "Continue" per verificare che il server sia riconosciuto
  4. Testa una richiesta semplice come "Calcola 5 + 3 usando Nexus"

๐Ÿšจ Troubleshooting

Problema: Container non si avvia
# Verifica i log
docker-compose logs nexus-mcp

# Verifica che le dipendenze siano installate
docker run --rm nexus-mcp-server:latest pip list
Problema: VSCode non riconosce il server
# Verifica la sintassi del file di configurazione
jq . < ~/.vscode/mcp-servers.json

# Verifica che Docker sia raggiungibile
docker --version
docker-compose --version
Problema: Errori di permessi sui volumi
# Verifica permessi directory safe_files
ls -la safe_files/

# Correggi permessi se necessario
chmod 755 safe_files/
Problema: Timeout di connessione
# Aumenta timeout nel docker-compose.yml
services:
  nexus-mcp:
    healthcheck:
      timeout: 30s
      interval: 60s

๐Ÿ“Š Monitoraggio e Performance

Utilizzo risorse
# Monitora utilizzo risorse
docker stats nexus-mcp-server

# Verifica health check
docker inspect nexus-mcp-server | grep -A 10 -B 5 Health
Log analysis
# Log in tempo reale
docker-compose logs -f nexus-mcp

# Log con timestamp
docker-compose logs -t nexus-mcp

# Ultimi 100 log
docker-compose logs --tail=100 nexus-mcp

โš™๏ธ Configurazione

Abilitare/Disabilitare Tool

Modifica config.json per controllare quali tool sono attivi:

{
  "comment": "Pannello di controllo per il server MCP Nexus",
  "enabled_tools": [
    "calculator",
    "filesystem_reader",
    "web_fetcher",
    "crypto_tools",
    "encoding_tools",
    "datetime_tools",
    "uuid_tools",
    "string_tools",
    "validator_tools",
    "system_info",
    "network_tools",
    "security_tools",
    "network_security_tools",
    "performance_tools",
    "data_analysis",
    "image_processing",
    "audio_processing",
    "video_processing",
    "unit_converter",
    "qr_code_tools",
    "regex_tools",
    "file_converter",
    "pdf_tools",
    "code_analysis_tools",
    "docker_tools",
    "git_tools",
    "process_management_tools",
    "code_generation_tools",
    "database_tools",
    "environment_tools",
    "backup_tools",
    "log_analysis_tools",
    "code_execution_tools",
    "cloud_tools",
    "weather_tools",
    "url_tools",
    "text_analysis_tools",
    "email_tools",
    "color_tools",
    "json_yaml_tools",
    "api_testing_tools",
    "template_tools",
    "markdown_tools",
    "archive_tools",
    "workflows"
  ]
}

Riavvia il server per applicare le modifiche.

Aggiungere Nuovi Tool

  1. Crea un nuovo file .py nella cartella tools/
  2. Implementa la funzione register_tools(mcp):
# tools/my_tool.py
import logging

def register_tools(mcp):
    logging.info("๐Ÿ“ Registrazione tool-set: My Tool")

    @mcp.tool()
    def my_function(param: str) -> str:
        """Descrizione della funzione."""
        return f"Risultato: {param}"
  1. Aggiungi "my_tool" alla lista enabled_tools in config.json

๐Ÿ”’ Sicurezza

Filesystem Reader

  • Sandbox: Accesso limitato alla directory safe_files/
  • Path Traversal Protection: Blocca ../, /, \\
  • Path Resolution: Verifica che il file sia effettivamente nel sandbox

Web Fetcher

  • Timeout: Richieste limitate a 10 secondi
  • Content Size: Limite 4000 caratteri per response
  • User-Agent: Identificazione richieste server

General

  • Input Validation: Tutti i parametri vengono validati
  • Error Handling: Gestione sicura degli errori senza leak
  • Logging: Monitoraggio completo attivitร 

๐Ÿ“‹ Requisiti Sistema

  • Python: 3.8+
  • Sistema Operativo: Linux, macOS, Windows
  • RAM: Minimo 512MB
  • Dipendenze: Vedere requirements.txt

Dipendenze Principali

mcp[cli]>=1.13.1      # Model Context Protocol
httpx>=0.28.1         # HTTP client asincrono  
psutil>=7.0.0         # Informazioni sistema
python-dateutil>=2.9  # Parsing date avanzato

๐Ÿงช Testing

Test Singolo Tool

python client.py <tool_name> '<json_args>'

Test Completo Sistema

# Test matematica
python client.py add '{"a": 10, "b": 5}'

# Test sicurezza filesystem  
python client.py read_safe_file '{"filename": "../config.json"}'  # Dovrebbe fallire

# Test validatori
python client.py validate_email '{"email": "invalid.email"}'

# Test sistema
python client.py system_overview '{}'

๐Ÿค Contribuire

Aggiungere Nuovi Tool

  1. Fork il repository
  2. Crea un branch per il tuo tool: git checkout -b feature/awesome-tool
  3. Implementa il tool seguendo le convenzioni esistenti
  4. Testa completamente la funzionalitร 
  5. Documenta nel README
  6. Crea una Pull Request

Linee Guida Tool

  • โœ… Sicurezza: Valida tutti gli input
  • โœ… Documentazione: Docstring complete
  • โœ… Error Handling: Gestione robusta errori
  • โœ… Logging: Info per debugging
  • โœ… Encoding: UTF-8 header nei file

๐Ÿ“œ Licenza

Questo progetto รจ rilasciato sotto licenza MIT. Vedi file LICENSE per dettagli.

๐Ÿ†˜ Supporto

Problemi Comuni

Q: Il server non trova un tool abilitato
A: Verifica che il file .py esista in tools/ e sia presente in config.json

Q: Errori di encoding
A: Assicurati che tutti i file abbiano header # -*- coding: utf-8 -*-

Q: Tool sistema non funziona
A: Verifica che psutil sia installato: pip install psutil

Q: Timeout nelle richieste web
A: Il timeout รจ configurato a 10 secondi. Alcune risorse potrebbero essere lente.

Debug

Abilita logging dettagliato modificando il livello in multi_server.py:

logging.basicConfig(level=logging.DEBUG, ...)