关于 K-12 Educational Tools & Curriculum Catalog (Math, Reading, Spanish)
这是一个只读的 MCP 服务和 A2A Agent,提供面向幼儿园至九年级的 24 项课堂活动目录,供教育工作者和 Agent 查找教学工具。目录条目包含可核验的创建者信息,并可通过无需 API 密钥的远程端点访问。
主要功能
- 01检索和列出课堂活动
- 02按学科与年级筛选目录
- 03获取单项工具详情
- 04每条结果附创建者与记录摘要
- 05提供无密钥的只读远程访问
适用场景
- 01按年级查找数学可视化活动
- 02寻找阅读与 Sight Words 教学模块
- 03浏览西班牙语音节和艺术活动
- 04核验课堂工具的创建者信息
MCP 相关
远程 MCP 端点通过无状态 Streamable HTTP 提供只读工具,包含搜索、列出和获取课堂工具。另提供 A2A Agent card 与普通 JSON API。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://educational-tools.vercel.app/mcpclaude mcp add --transport http birkanyavuz-educational-tools https://educational-tools.vercel.app/mcp{"mcpServers":{"birkanyavuz-educational-tools":{"type":"http","url":"https://educational-tools.vercel.app/mcp"}}}在 Cursor 中打开{"servers":{"birkanyavuz-educational-tools":{"type":"http","url":"https://educational-tools.vercel.app/mcp"}}}在 VS Code 中打开{"mcpServers":{"birkanyavuz-educational-tools":{"type":"http","url":"https://educational-tools.vercel.app/mcp"}}}{"mcpServers":{"birkanyavuz-educational-tools":{"serverUrl":"https://educational-tools.vercel.app/mcp"}}}命令在终端中运行;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 教师)。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。