MCP.so
登录

Smartschool MCP Server

@AbriantoLabs

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

AbriantoLabs

提交者

Maarten Coppens

关于 Smartschool MCP Server

A dynamic Model Context Protocol (MCP) server that provides AI assistants with secure access to Smartschool APIs. This server automatically discovers all available Smartschool methods and exposes them as MCP tools with comprehensive safety guardrails.

Smartschool MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "smartschool": {
      "command": "node",
      "args": [
        "/path/to/smartschool-mcp-server/build/mod.js"
      ],
      "env": {
        "SMARTSCHOOL_API_ENDPOINT": "https://your-school.smartschool.be/Webservices/V3",
        "SMARTSCHOOL_ACCESS_CODE": "your-access-code",
        "ALLOW_DESTRUCTIVE": "false",
        "REQUIRE_CONFIRMATION": "true"
      }
    }
  }
}

Smartschool MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Smartschool Mcp?

Smartschool Mcp is a Model Context Protocol (MCP) server that gives AI assistants secure, dynamically discovered access to Smartschool APIs. It automatically detects all available Smartschool methods and exposes them as MCP tools with built‑in safety guardrails.

How to use Smartschool Mcp?

Install via npm (npm install and build), set environment variables (SMARTSCHOOL_API_ENDPOINT, SMARTSCHOOL_ACCESS_CODE, and optionally ALLOW_DESTRUCTIVE and REQUIRE_CONFIRMATION), then configure your MCP client (e.g., Claude Desktop) to launch the server using npx -y @abrianto/smartschool-mcp or manually via node build/mod.js. The server communicates over stdio.

Key features of Smartschool Mcp

  • Dynamic auto-discovery of all Smartschool API methods
  • Enterprise safety with four protection levels (SAFE, MODERATE, DESTRUCTIVE, CRITICAL)
  • AI-optimized context including Belgian school conventions and absence codes
  • Zero maintenance – no manual tool definitions required
  • Future-proof – adapts automatically when Smartschool SDK updates
  • Built-in domain expertise for Belgian school systems

Use cases of Smartschool Mcp

  • Manage users (create, update, delete) with confirmation for destructive actions
  • Handle class and group assignments (save, delete classes, assign students)
  • Send messages to students and parents via Smartschool’s messaging system
  • Check attendance records and academic history
  • Perform system administration tasks like synchronisation and support tickets

常见问题

1

What are the safety levels and how do they work?

The server classifies operations into SAFE (read‑only, no restrictions), MODERATE (reversible changes, always allowed), DESTRUCTIVE (high‑impact changes, requires `ALLOW_DESTRUCTIVE=true`), and CRITICAL (permanent deletions, requires `ALLOW_DESTRUCTIVE=true` and the `confirmDestructiveAction` parameter).

2

What are the runtime requirements?

Node.js 18+ or a compatible JavaScript runtime, access to a Smartschool instance, valid API credentials (endpoint and access code), and network connectivity to the Smartschool API endpoint.

3

How do I enable destructive operations?

Set the environment variable `ALLOW_DESTRUCTIVE=true` and include `confirmDestructiveAction: true` in the tool call parameters. By default, destructive operations are blocked in production.

4

What data does the server access?

The server connects to Smartschool’s V3 API and requires permissions for user management, group/class management, messaging, and reporting. Credentials should be kept secure and not committed to version control.

5

How does the server handle authentication and transport?

It uses stdio transport per the MCP specification. Authentication is provided via the `SMARTSCHOOL_ACCESS_CODE` environment variable. No other transports or authentication methods are documented.

评论

其他 分类下的更多 MCP 服务器