项目简介
Skolverket MCP Server是一个基于Model Context Protocol (MCP)构建的后端服务,旨在将瑞典国家教育局(Skolverket)的开放API(包括课程计划API、学校单位注册API和计划教育API)整合到AI助手中。它为ChatGPT、Claude等LLM系统提供标准化接口,以获取瑞典的教育数据,如课程、主题、高中项目、学校单位以及成人教育信息。该服务器支持多种传输协议,并具备日志、缓存、速率限制和输入验证等高级功能,确保为AI应用提供稳定、可扩展的上下文服务。
主要功能点
- 课程计划查询: 查询瑞典的课程计划、科目、课程和高中项目,包括详细内容、知识要求和版本历史。
- 学校单位信息: 搜索、筛选和获取瑞典学校(包括学前班、小学、中学和成人教育机构)的详细信息,例如名称、状态和地址。
- 成人教育查询: 查找职业学院(YH)、SFI(瑞典语为移民提供)和Komvux(成人教育)等成人培训项目,支持按城市、距离、学习节奏等条件筛选。
- 上下文资源提供: 提供关于API信息、学校类型、课程计划类型和教育区域的静态数据作为LLM的上下文。
- 预设交互模板: 提供多个Prompt模板,如课程分析、课程计划版本比较、成人教育搜索、学习路径规划和教师课程规划,简化LLM与教育数据的交互。
- 系统诊断: 包含健康检查工具,用于诊断API连接和服务器状态,确保系统正常运行。
安装步骤
该服务器提供在线服务和本地安装两种方式。
- 在线服务(推荐): 服务器已部署并可在以下URL直接访问: 'https://skolverket-mcp.onrender.com/mcp' 无需任何安装即可使用。
- 本地安装: 如果在线服务达到带宽限制或需要自定义配置,您可以本地运行服务器。 首先,请确保您的系统已安装Node.js和npm。 克隆项目仓库: 'git clone https://github.com/KSAklfszf921/Skolverket-MCP.git' 进入项目目录: 'cd Skolverket-MCP' 安装依赖: 'npm install' 编译项目(TypeScript): 'npm run build' 运行stdio模式的MCP服务器(适用于命令行工具和需要stdio传输的客户端): 'npm start' 运行HTTP/SSE模式的MCP服务器(适用于Web端聊天机器人和需要HTTP传输的客户端): 'npm run start:streamable'
服务器配置
MCP客户端通常需要一个配置文件来连接到MCP服务器。以下是针对不同客户端的典型配置信息,您需要根据实际运行模式(在线服务或本地安装)选择合适的URL或命令。
对于需要HTTP传输的MCP客户端 (例如 ChatGPT、Claude Desktop/Code (HTTP), OpenAI Codex (HTTP), Cline (HTTP), Gemini CLI (HTTP)) MCP客户端需要配置服务器名称(例如 "skolverket")和服务器URL。
- 如果使用在线服务,URL为:'https://skolverket-mcp.onrender.com/mcp'
- 如果使用本地HTTP/SSE服务器(通过 'npm run start:streamable' 启动),URL为:'http://localhost:3000/mcp' (端口可能根据配置有变)
例如,Claude Desktop的HTTP传输配置信息:
{ "mcpServers": { "skolverket": { "transport": "http", "url": "https://skolverket-mcp.onrender.com/mcp" } } }
'mcpServers': 用于配置MCP服务器列表的顶级键。 'skolverket': 您为此MCP服务器定义的名称,客户端将通过此名称引用。 'transport': 指定传输协议,这里是"http"。 'url': MCP服务器的访问地址。
对于需要Stdio传输的MCP客户端 (例如 Claude Desktop/Code (Stdio), OpenAI Codex (Stdio), Cline (Stdio), Gemini CLI (Stdio)) MCP客户端需要配置服务器名称(例如 "skolverket")以及启动服务器的命令和参数。
- 如果使用本地Stdio服务器(通过 'npm start' 启动),命令为 'npx',参数为 '["-y", "skolverket-mcp"]'。
例如,Claude Desktop的Stdio传输配置信息:
{ "mcpServers": { "skolverket": { "command": "npx", "args": ["-y", "skolverket-mcp"] } } }
'mcpServers': 用于配置MCP服务器列表的顶级键。 'skolverket': 您为此MCP服务器定义的名称,客户端将通过此名称引用。 'command': 启动MCP服务器的 shell 命令。 'args': 传递给启动命令的参数数组。
请注意,具体的配置格式可能因MCP客户端而异,请参考您所使用的MCP客户端的文档。
基本使用方法
连接MCP服务器后,您的AI助手将能够:
- 提问关于瑞典教育体系的问题: 例如,“瑞典高中有什么课程?”或者“斯德哥尔摩有哪些职业教育项目?”
- 获取特定课程详情: 例如,“请告诉我MATMAT01c课程的核心内容和知识要求。”
- 比较课程版本: 例如,“比较一下LGR11和GY11课程计划的数学科目有什么不同?”
- 规划学习路径: 例如,“如果我对编程感兴趣,瑞典高中有什么推荐的课程或项目?”
- 查找学校信息: 例如,“列出所有状态为‘AKTIV’的学校单位。” AI助手将通过调用服务器提供的工具和访问资源来回答这些问题。
信息
分类
网页与API