🚀 Nexus MCP Server

Nexus is an advanced, modular, and configurable MCP (Model Context Protocol) server that acts as a central hub for integrating a wide range of custom tools, making them available to Large Language Models (LLMs) like Claude and VS Code Copilot.

🎯 Latest Update: Version 0.9.1 with Enhanced HTTP API, Dynamic Tool Creation, and Production Monitoring

🛠️500+ Tools

Over 500 functions across 120+ tools in 17 categories - from mathematical operations to security scanning

🔒Security First

Sandboxed execution, input validation, resource limits, and comprehensive security features

⚡Dynamic Creation

Create custom tools on-the-fly with secure Docker execution for any computational task

🌐Universal API

REST API access from any programming language - Python, JavaScript, Go, Rust, Java, C#

⚡ Quick Start

Prerequisites: Python 3.8+, Git, and optionally Docker for enhanced features

1. Clone and Setup

# Clone the repository
git clone https://github.com/fabriziosalmi/nexus-mcp-server.git
cd nexus-mcp-server

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate   # Windows

# Install dependencies
pip install -r requirements.txt

2. Test Installation

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

# List available tools
python list_tools.py

3. Configure Your Client

🔧 VS Code Setup

Configure for VS Code Copilot with optimized tool subset

Setup Guide →

🤖 Claude Desktop

Full feature access with all 500+ tools

Setup Guide →

🎯 Key Features

🧮Mathematical Operations

Advanced calculator, statistics, financial calculations, unit conversions

  • Basic arithmetic and advanced math
  • Statistical analysis functions
  • Financial calculations
  • Unit converter with 50+ units

🔒Security & Cryptography

Password generation, encryption, vulnerability scanning, network security

  • Password and hash generation
  • Encryption/decryption utilities
  • Network security scanning
  • Vulnerability assessment

💻Code Generation

Project scaffolding, API generation, design patterns, code analysis

  • Project template generation
  • API scaffolding
  • Code quality analysis
  • Design pattern implementation

📁File Operations

Format conversion, archiving, PDF processing, image manipulation

  • File format conversion
  • Archive management
  • PDF document processing
  • Image processing and analysis

⚙️System Management

Process monitoring, Docker integration, Git operations, performance analysis

  • System information gathering
  • Process monitoring
  • Docker container management
  • Git repository operations

🌐Network Tools

Security scanning, DNS lookups, website analysis, connectivity testing

  • Network connectivity testing
  • DNS resolution and analysis
  • Website performance analysis
  • Port scanning and security

⚡ Advanced Capabilities

  • Dynamic Tool Creation: Create custom tools on-the-fly using create_and_run_tool
  • Web Configuration Interface: Real-time tool management without restarts
  • Docker Integration: Secure, isolated execution environments
  • Hot Reload: Update configurations without server downtime
  • Multi-Client Support: Works with VS Code, Claude Desktop, and HTTP API
  • Automatic Client Detection: VSCode gets curated 99-function subset, Claude Desktop gets full 500+ functions

🔒 Security First

  • Sandboxed file operations in safe_files/ directory
  • Input validation and sanitization
  • Resource limits and timeout protection
  • Path traversal prevention
  • Docker-based isolation for dynamic tools
  • Comprehensive security scanning tools

📸 Screenshots

Claude Desktop Integration

Claude Desktop Integration

Nexus MCP Server seamlessly integrated with Claude Desktop, providing access to all 500+ tools

Tool Usage Examples

UUID Generation Example 1

UUID Generation

Example of generating UUIDs with different formats and validation

UUID Generation Example 2

Advanced UUID Operations

Advanced UUID operations with validation and format conversion