🤖 Claude Desktop Setup

Configure Nexus MCP Server with Claude Desktop to access the complete suite of 500+ tools and advanced features including dynamic tool creation.

📋 Prerequisites

⚙️ Installation & Configuration

Step 1: Install Nexus MCP Server

# 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

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

Step 2: Configure Claude Desktop

Claude Desktop reads its configuration from a JSON file in your user directory. The location depends on your operating system:

Step 3: Add Nexus Configuration

Create or edit the Claude Desktop configuration file with the following content:

{
  "mcpServers": {
    "nexus": {
      "command": "python",
      "args": ["/absolute/path/to/nexus-mcp-server/multi_server.py"],
      "env": {
        "PYTHONPATH": "/absolute/path/to/nexus-mcp-server",
        "MCP_SERVER_NAME": "NexusServer",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

Step 4: Pre-configured Templates

Nexus provides ready-to-use configuration templates in the repository:

cp claude_desktop_config.json ~/.config/Claude/claude_desktop_config.json

cp claude_desktop_config_minimal.json ~/.config/Claude/claude_desktop_config.json

✅ Verification & Testing

Step 1: Restart Claude Desktop

1. Completely quit Claude Desktop
2. Wait 5 seconds
3. Restart the application
4. Wait for the server to initialize (10-15 seconds)

Step 2: Test the Connection

In a new Claude conversation, try these test commands:

Can you add 15 and 27 using your tools?

What's the current system information?

Step 3: Test Advanced Features

"Can you create a tool that converts temperatures from Celsius to Fahrenheit and test it with 25°C?"

🎯 Available Features

Tool Categories (500+ Tools)

🛠️ Dynamic Tool Creation

Claude Desktop gets access to the most advanced Nexus feature - dynamic tool creation:

🚀 Usage Examples

Basic Tool Usage

Advanced Examples

"I need to parse a custom log format that looks like this:
'[2024-01-15 10:30:45] ERROR: Connection failed to 192.168.1.100:8080'

Can you create a tool to extract the timestamp, level, and IP address from such logs?"

Workflow Examples

🔍 Troubleshooting

Common Issues

Debug Steps

1. Verify Configuration:

# Check config file exists and is valid JSON
cat ~/.config/Claude/claude_desktop_config.json | python -m json.tool

2. Test Server Manually:

cd /path/to/nexus-mcp-server
source .venv/bin/activate
python multi_server.py

# In another terminal
python client.py system_overview

3. Check Logs:

Enable debug logging by setting LOG_LEVEL to DEBUG in the configuration:

{
  "mcpServers": {
    "nexus": {
      "env": {
        "LOG_LEVEL": "DEBUG"
      }
    }
  }
}

⚡ Performance & Optimization

Resource Usage

Nexus is optimized for Claude Desktop usage:

• Memory Usage: ~50-100MB baseline, scales with active tools
• CPU Usage: Minimal when idle, scales with tool complexity
• Storage: ~100MB for base installation, additional for dynamic tools
• Network: Only for tools that require internet access

Optimization Tips

"env": {
  "ENABLED_TOOLS": "essential,math,security"
}

"env": {
  "DOCKER_MEMORY_LIMIT": "128m",
  "DOCKER_CPU_LIMIT": "0.5"
}

🎯 Next Steps