Cyberedu Mcp Server

by CyberEDU-Cyber-Range

143 downloads

Not rated

GitHub

About

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

Details

Author: CyberEDU-Cyber-Range
Downloads: 143
Categories: Productivity, Other, Security

- Dynamic tool discovery from CyberEduClient methods
- Zero configuration for new client methods
- Type-safe JSON schema generation from signatures
- Comprehensive error handling with detailed messages
- Automatic session credential persistence to disk
- Supports multiple MCP client configurations

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

Clone the repository with submodules, set up a Python virtual environment, and install the package using pip install -e ".[local]". Run the server with python -m cyberedu_mcp. After first authentication via the cyberedu_set_session_cookie tool, session credentials are persisted to disk, so no environment variables are needed on subsequent runs. Configure MCP clients like Cursor, Claude Desktop, or VS Code by pointing to the full Python executable path in your venv.

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"
        ]
    }
}

CyberEdu MCP Server

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

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

CyberEdu MCP Server

Features

CyberEDU Platform Overview

Core Description

Key Differentiators

Platform Components

Key Statistics

Target Audiences

Deployment Options

Installation

Clone the Repository

Install Packages

Install

More like this

Sequential Thinking

Time

Filesystem

EverArt

Google Drive

Reactive Resume