https://github.com/hyperskill/mcp
Hyperskill MCP
https://github.com/hyperskill/mcp
Last synced: 5 months ago
JSON representation
Hyperskill MCP
- Host: GitHub
- URL: https://github.com/hyperskill/mcp
- Owner: hyperskill
- Created: 2025-04-11T19:47:45.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-04-14T12:54:24.000Z (about 1 year ago)
- Last Synced: 2025-04-14T13:56:41.835Z (about 1 year ago)
- Language: Python
- Size: 111 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- metorial-index - Hyperskill Integration Server - Provides explanations of programming topics using Hyperskill's educational resources, enabling searches and connections to relevant programming concepts. Facilitates learning by linking code topics to structured content from Hyperskill. (Content Creation)
README
# MCP-Hyperskill
A FastMCP integration with Hyperskill that allows AI agents to explain programming topics using Hyperskill's learning resources.
## Features
- Get explanations of code concepts with links to Hyperskill topics
- Search for programming topics on Hyperskill
## Installation
```bash
# Install dependencies using UV with pyproject.toml
uv sync
```
## Usage
To run the server:
```bash
uv run main.py
```
This will start a server on `http://0.0.0.0:8080` that AI agents can connect to.
### Command-line Arguments
The server supports the following command-line arguments:
```bash
uv run main.py [--host HOST] [--port PORT] [--debug]
```
- `--host HOST`: Host to bind the server to (default: 0.0.0.0)
- `--port PORT`: Port to bind the server to (default: 8080)
- `--debug`: Run in debug mode
Example:
```bash
uv run main.py --host 127.0.0.1 --port 9000 --debug
```
## MCP Tools
### explain_topics_in_the_code
Explains programming topics present in code by finding relevant Hyperskill resources.
Parameters:
- `topics`: List of key topics or concepts that need explanation
- `programming_language`: Programming language of the given code
### find_topics_on_hyperskill
Searches Hyperskill for specific programming topics.
Parameters:
- `topics`: List of topic keywords to search for
- `programming_language`: Programming language to filter topics by
## Example Usage
When interacting with an AI agent that has access to MCP-Hyperskill, you can ask:
```
Explain topics in the code using Hyperskill:
def fibonacci(n):
if n <= 1:
return n
else:
return fibonacci(n-1) + fibonacci(n-2)
result = fibonacci(10)
print(result)
```
The AI agent will identify key concepts like "recursion", "functions", and "fibonacci sequence" and provide Hyperskill links for learning more about these topics.
The response will include:
- Topic titles
- Links to Hyperskill learning resources
- Topic hierarchies showing where these concepts fit in the curriculum
Example of AI explaining code topics with Hyperskill resources in Cursor