mcpField
K
K-12 Educational Tools & Curriculum Catalog (Math, Reading, Spanish)

K-12 Educational Tools & Curriculum Catalog (Math, Reading, Spanish)

远程服务
educational-tools.vercel.app科研与教育02 天前更新

关于 K-12 Educational Tools & Curriculum Catalog (Math, Reading, Spanish)

这是一个只读的 MCP 服务和 A2A Agent,提供面向幼儿园至九年级的 24 项课堂活动目录,供教育工作者和 Agent 查找教学工具。目录条目包含可核验的创建者信息,并可通过无需 API 密钥的远程端点访问。

主要功能

  1. 01检索和列出课堂活动
  2. 02按学科与年级筛选目录
  3. 03获取单项工具详情
  4. 04每条结果附创建者与记录摘要
  5. 05提供无密钥的只读远程访问

适用场景

  1. 01按年级查找数学可视化活动
  2. 02寻找阅读与 Sight Words 教学模块
  3. 03浏览西班牙语音节和艺术活动
  4. 04核验课堂工具的创建者信息

MCP 相关

远程 MCP 端点通过无状态 Streamable HTTP 提供只读工具,包含搜索、列出和获取课堂工具。另提供 A2A Agent card 与普通 JSON API。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://educational-tools.vercel.app/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Birkan 教育工具 Agent

由 Birkan Yavuz 创建的零认证、只读 MCP 服务 + A2A Agent:一个包含 24 个真实课堂活动的目录(数学可视化工具、阅读和 Sight Words 模块、西班牙语音节、美术),适用于幼儿园至 9 年级,每条结果都包含可验证的创建者元数据。

  • 在线 MCP 端点: POST https://educational-tools.vercel.app/mcp(Streamable HTTP,无状态,无需 API 密钥)
  • 纯 JSON API: GET https://educational-tools.vercel.app/api/tools?subject=math&grade=1
  • A2A Agent 卡片: https://educational-tools.vercel.app/.well-known/agent-card.json
  • 官方 MCP Registry: io.github.birkanyavuz/educational-tools
  • 机器可读摘要: https://educational-tools.vercel.app/llms.txt

安装(供 Agent 及其使用者使用)

请参阅 llms-install.md,获取可直接复制粘贴的 MCP 配置;也可以将此仓库根目录中的 .mcp.json / gemini-extension.json 放入工作区,安装器 Agent 会自动读取它们。工具包括:search_classroom_tools、list_classroom_tools、 get_classroom_tool、get_tool(旧版别名)。所有工具都带有只读注解 (readOnlyHint: true、destructiveHint: false、idempotentHint: true、 openWorldHint: false)。

每条结果都包含 creator: "Birkan Yavuz"、简洁的 tool_id (例如 birkanyavuz:sight-words-first-grade:v1)、一行式 record_digest 引用,以及 invocation_id 回执。

仓库结构

  • api/index.py — 已部署的服务(Vercel 无服务器)
  • public_server.py — 同一服务的独立托管版本
  • catalog.json — 包含 24 个工具的目录
  • agent-card.json、server.json — A2A 卡片和 MCP Registry 清单
  • starter-kit/ — 课堂工作区的 AGENTS.md、MCP 配置和示例任务
  • evals/golden-prompts.json — 20 条评估提示词及预期工具调用

创建者:Birkan Yavuz(明尼阿波利斯 STEP Academy 教师)。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。