Cyberedu Mcp Server

by CyberEDU-Cyber-Range

143 downloads Not rated yet

GitHub

About

This is the Oficial Model Context Protocol (MCP) server for the CyberEdu CTF platform (cyber-edu.co / cyberedu.ro)

Explore

- Dynamic Tool Discovery: Automatically discovers all public methods from CyberEduClient and exposes them as MCP tools
- Zero Configuration for New Methods: When new methods are added to CyberEduClient, they automatically become available as MCP tools without any code changes
- Type-Safe: Automatically generates JSON schemas from method signatures and type hints
- Error Handling: Comprehensive error handling with detailed error messages

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Cyberedu Mcp Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

From the repository

- Cloud-hosted SaaS (browser-based, no installation)
- On-premise (VMware, Proxmox, bare-metal)
- Air-gapped deployments for classified environments

Install both packages (client and MCP server):

macOS/Linux:
``bash python3 -m venv venv source venv/bin/activate pip install -e ".[local]" # Installs with local cyberedu-client submodule

`Windows (PowerShell):`powershell python -m venv venv .\venv\Scripts\Activate.ps1 pip install -e ".[local]" # Installs with local cyberedu-client submodule`Windows (Command Prompt):`cmd python -m venv venv venv\Scripts\activate.bat pip install -e ".[local]"`> Alternative: Install packages separately: >`bash > pip install -e ./cyberedu-client > pip install -e . >



You can also use environment variables. The server loads credentials in this priority order:

1. Persisted credentials from disk (highest priority)

2. Environment variables

3. Defaults



Environment variables:

- CYBEREDU_SESSION_COOKIE: Your CyberEdu session cookie

  - Get this from your browser's developer tools after logging in to https://app.cyber-edu.co

  - Look for the cyberedu_session cookie value

- CYBEREDU_TENANT: Your tenant identifier (optional, defaults to "cyberedu")
Chrome/Edge:

1. Open Developer Tools (F12)

2. Go to Application/Storage tab

3. Navigate to Cookies → https://app.cyber-edu.co

4. Find cyberedu_session and copy its value



Firefox:

1. Open Developer Tools (F12)

2. Go to Storage tab

3. Navigate to Cookies → https://app.cyber-edu.co

4. Find cyberedu_session and copy its value

The server can be run directly (for testing):



macOS/Linux:

bash

python3 -m venv venv



source venv/bin/activate

python -m cyberedu_mcp





Windows:

powershell

python -m venv venv

.\venv\Scripts\Activate.ps1

python -m cyberedu_mcp



To use this server with an MCP client (Cursor IDE or Claude Desktop), add it to your MCP configuration.



Important: Use the full path to the Python executable in your venv. MCP clients run servers externally and won't have access to an activated virtual environment.
- cyberedu_check_auth - Verify authentication and get user info

- cyberedu_get_user_info - Get full user information

- cyberedu_list_tenants - List all available tenants

- cyberedu_get_current_tenant_info - Get current tenant information

- cyberedu_get_user - Get user information by ID

Example prompts for interacting with the CyberEdu MCP server:


"Check my CyberEdu session status"

"Set my CyberEdu session cookie to eyJpdiI6Ik..."

"Switch to tenant 'mycompany'"

The server automatically exposes all public methods from CyberEduClient as MCP tools. Tools are prefixed with cyberedu_ to avoid naming conflicts.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cyberedu mcp server": {
            "cyberedu": {
                "command": "/path/to/cyberedu-mcp/venv/bin/python3",
                "args": [
                    "-m",
                    "cyberedu_mcp"
                ]
            }
        }
    }
}

McpServers

{
    "cyberedu": {
        "command": "/path/to/cyberedu-mcp/venv/bin/python3",
        "args": [
            "-m",
            "cyberedu_mcp"
        ]
    }
}

This is the Oficial Model Context Protocol (MCP) server for the CyberEdu CTF platform (https://cyber-edu.co / https://cyberedu.ro). This server automatically discovers and exposes all methods from the CyberEduClient as MCP tools, making it easy to interact with the CyberEdu platform through MCP-compatible clients.

Features

- Dynamic Tool Discovery: Automatically discovers all public methods from CyberEduClient and exposes them as MCP tools - Zero Configuration for New Methods: When new methods are added to CyberEduClient, they automatically become available as MCP tools without any code changes - Type-Safe: Automatically generates JSON schemas from method signatures and type hints - Error Handling: Comprehensive error handling with detailed error messages

CyberEDU Platform Overview

CyberEDU is a cybersecurity training platform that provides hands-on labs, realistic simulations, and competitive environments. It’s designed for enterprise security teams, academic institutions, government agencies, and individual learners.

Core Description

CyberEDU is a comprehensive cybersecurity training platform that provides hands-on labs, realistic simulations, and competitive environments. It's designed for enterprise security teams, academic institutions, government agencies, and individual learners who want to develop practical cybersecurity skills through real-world scenarios.

Key Differentiators

- Hands-on approach: Interactive cyber ranges where users attack and defend real infrastructure (not just videos or theory) - MITRE ATT&CK mapping: Scenarios mapped to MITRE ATT&CK, using real malware samples (safely contained) - Better retention: 3.5x better skill retention compared to passive learning - Real-world scenarios: Simulates actual adversary techniques and attack patterns

Platform Components

1. Cyber Range — Enterprise-scale cyber warfare simulation with complex network topologies 2. Cyber Labs — 650+ hands-on labs mapped to MITRE ATT&CK, browser-based and auto-graded 3. Tournament Suite — Gamified competitions (CTFs, Red vs Blue, war games)

Key Statistics

- 30,000+ active users worldwide - 650+ hands-on labs - 1,400+ simulation profiles - 500+ events hosted - 45+ countries served - 250+ hours of training content

Target Audiences

- Students: Career-focused training with CTF challenges and leaderboards - Academia: Curriculum with LMS integration and auto-grading - Enterprise: Technical hiring assessments, team training, compliance mapping - Government: Air-gapped deployments, OT/SCADA simulation, critical infrastructure defense

Deployment Options

- Cloud-hosted SaaS (browser-based, no installation) - On-premise (VMware, Proxmox, bare-metal) - Air-gapped deployments for classified environments

Installation

Clone the Repository

The cyberedu-client is included as a git submodule. Clone with --recursive to get everything: ``

bash
git clone --recursive https://github.com/CyberEDU-Cyber-Range/cyberedu-mcp.git
cd cyberedu-mcp



If you already cloned without

--recursive

, initialize the submodule:

bash
git submodule update --init --recursive



Install Packages


Install both packages (client and MCP server):

macOS/Linux:

``bash python3 -m venv venv source venv/bin/activate pip install -e ".[local]" # Installs with local cyberedu-client submodule

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Features

CyberEDU Platform Overview

Core Description

Key Differentiators

Platform Components

Key Statistics

Target Audiences

Deployment Options

Installation

Clone the Repository

Install Packages

More like this

Sequential Thinking

Time

Filesystem

EverArt