MCP-Hyperskill

一个将 FastMCP 与 Hyperskill 集成的工具，允许 AI 代理使用 Hyperskill 的学习资源来解释编程主题。

特性

• 获取代码概念的解释，并提供指向 Hyperskill 主题的链接
• 在 Hyperskill 上搜索编程主题

安装

# 使用 UV 和 pyproject.toml 安装依赖
uv sync

用法

要运行服务器：

uv run main.py

这将在 http://0.0.0.0:8080 上启动一个服务器，AI 代理可以连接到该服务器。

命令行参数

服务器支持以下命令行参数：

uv run main.py [--host HOST] [--port PORT] [--debug]

• --host HOST: 服务器绑定的主机 (默认: 0.0.0.0)
• --port PORT: 服务器绑定的端口 (默认: 8080)
• --debug: 以调试模式运行

示例:

uv run main.py --host 127.0.0.1 --port 9000 --debug

MCP 工具

explain_topics_in_the_code

通过查找相关的 Hyperskill 资源来解释代码中存在的编程主题。

参数:

• topics: 需要解释的关键主题或概念列表
• programming_language: 给定代码的编程语言

find_topics_on_hyperskill

在 Hyperskill 上搜索特定的编程主题。

参数:

• topics: 要搜索的主题关键词列表
• programming_language: 用于过滤主题的编程语言

使用示例

当与可以访问 MCP-Hyperskill 的 AI 代理交互时，您可以询问：

使用 Hyperskill 解释代码中的主题：


def fibonacci(n):
    if n <= 1:
        return n
    else:
        return fibonacci(n-1) + fibonacci(n-2)

result = fibonacci(10)
print(result)

AI 代理将识别诸如“递归”、“函数”和“斐波那契数列”之类的关键概念，并提供 Hyperskill 链接以了解有关这些主题的更多信息。

响应将包括：

• 主题标题
• 指向 Hyperskill 学习资源的链接
• 主题层次结构，显示这些概念在课程中的位置

<div align="center"> <img src="resources/cursor_example.webp" alt="Example of topic explanation in Cursor" width="600"> <p><em>Cursor 中 AI 使用 Hyperskill 资源解释代码主题的示例</em></p> </div>