Teacher Toolkit MCP

教师工具包mcp

目标平台：macOS（苹果硅）。单一二进制文件，无运行时依赖关系。

安装

家酿

brew install andinger/tap/teacher-toolkit-mcp

二进制下载

下载自 发布.

从源代码构建

go install github.com/andinger/teacher-toolkit-mcp@latest

Claude桌面配置

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "teacher-toolkit": {
      "command": "teacher-toolkit-mcp"
    }
  }
}

工具

搜索材料

使用macOS Spotlight搜索教材(mdfind).支持PDF、DOCX和PPTX文件。

阅读材料

使用从文档中提取文本内容 textutil （DOCX/PPTX）和 pdftotext （PDF）。包括路径遍历保护和可配置截断。

搜索图片

在多个提供商（Pixabay、Openclipart）中搜索免许可证图像。结果按黑白打印适用性排序。

download_image

下载图像并将其作为base64编码数据返回。包括重复数据消除缓存。

search_lehrplan

使用全文搜索（SQLite FTS5）搜索LehrplanPLUS拜仁课程数据库。按学科（Fach）、年级（Jahargansstufe）和学校类型筛选。

set_config

配置工具箱：Pixabay API键、搜索目录、缓存目录和学校类型（Schulart）。

配置

配置文件： ~/.config/teacher-toolkit/config.yaml

lehrplan:
  last_sync: "2026-03-07T14:30:00Z"
  sync_interval: "168h"
  schulart: "mittelschule"
images:
  pixabay_api_key: ""
  cache_dir: "~/Unterrichtsmaterial/Bilder"
material:
  search_dir: "~/Unterrichtsmaterial"

Lehrplan同步

课程数据库在后台自动同步。强制手动同步：

teacher-toolkit-mcp --sync-lehrplan

发展

go test -race ./...                          # Unit tests
go test -race -tags=integration ./...        # Integration tests
go test -race -tags=e2e ./e2e/...            # E2E tests
goreleaser build --snapshot --clean          # Cross-compile snapshot

看 贡献.md 了解详情。

许可证

麻省理工学院