少儿编程通 MCP 服务器

把「少儿编程通」skill（191 条记录）变成可远程调用的 MCP 服务器，供 Qoder 这类远端 agent 靠 URL 调用。只读原 skill 的数据文件，不改动原 skill 包。

• 数据来源：/home/hatch/workspace/skills/kids-coding-tutor/assets/records.jsonl（可用环境变量 KIDS_CODING_RECORDS 换路径）
• 检索/规划/刷题逻辑与原 skill 的 search.py、answer.py、plan.py、quiz.py、videos.py 一致
• 技术栈：官方 mcp SDK（v1，FastMCP）+ streamable-http transport，Python 3.12，依赖装在项目自带 .venv，不动系统全局

本地启动

cd ~/workspace/mcp-servers/kids-coding-tutor
.venv/bin/python server.py --host 127.0.0.1 --port 8000

启动后 MCP 端点：http://127.0.0.1:8000/mcp

自测（需另开一个终端，先启动服务器再跑）：

cd ~/workspace/mcp-servers/kids-coding-tutor
.venv/bin/python test_client.py http://127.0.0.1:8000/mcp

Qoder 配置示例（mcp.json，URL 形式）

端口先写占位，部署到服务器后把 <服务器地址> 和 <端口> 换成实际值：

{
  "mcpServers": {
    "kids-coding-tutor": {
      "url": "http://<服务器地址>:<端口>/mcp",
      "transport": "streamable-http"
    }
  }
}

在 Qoder 里添加远程 MCP 服务器时粘贴上面这个 URL 即可（若 Qoder 界面字段名不同，按其提示填 URL 与 streamable-http 类型）。

注意：本服务器的 streamable-http 端点本身不带鉴权，不要直接裸暴露到公网；远端部署时请放在反向代理后加鉴权，或只放在内网/可信网络使用。

工具（7 个，全部返回纯中文正文）

实测结果（2026-10-26，MCP SDK 客户端实际调通）

7 个工具全部调通，无失败项。

目录

• server.py：服务器本体（FastMCP + streamable-http）
• test_client.py：SDK 客户端实测脚本
• .venv/：项目自带虚拟环境（mcp 1.30.0，FastMCP）