MCP-Hyperskill

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

功能

• 获取带有 Hyperskill 主题链接的代码概念解释
• 在 Hyperskill 上搜索编程主题

安装

# Install dependencies using UV with 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 代理交互时，你可以问：

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)

AI 代理会识别出诸如“递归”、“函数”和“斐波那契数列”等关键概念，并提供 Hyperskill 链接以便进一步学习这些主题。

响应将包括：

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