使用说明
QuizHP MCP服务器
一个交互式问答MCP服务器，可以将任何主题转换为可玩的迷你游戏。每个问题都呈现为一个独特的画布游戏——射箭、谜题、开关和125多个模板。
特性
- 125+游戏模板 --MCQ和真/假问题各有一个独特的迷你游戏（钢琴键、宝箱、射箭、拆弹等）
- 多平台 --桌面和移动设备的响应式布局，支持全屏
- MCP应用程序用户界面 --在Claude或ChatGPT中呈现的丰富交互式小部件
- 三种部署模式 --stdio（克劳德桌面）、HTTP（远程服务器）、Cloudflare Worker
- 成绩报告 --测验结果发回人工智能进行后续讨论
- 无外部依赖关系 -所有模板都捆绑在一起，不需要API调用
安装
npm install quizhp
克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"quizhp": {
"command": "npx",
"args": ["-y", "quizhp"]
}
}
}
Claude.ai（远程HTTP）
部署服务器并通过MCP端点连接：
# Start the HTTP server
npx quizhp start
# Or run directly
node dist/server/index.js
MCP端点位于 http://localhost:3001/mcp.
ChatGPT
部署HTTP服务器，并将ChatGPT的MCP集成指向您的 /mcp 终点。CORS已预先配置 chatgpt.com 和 chat.openai.com.
Cloudflare工作人员
# Deploy to Cloudflare Workers
npx wrangler deploy
使用示例
基础测验
问克劳德：
“太阳系问答”
克劳德提出问题并致电 play-quiz 工具。每个问题都显示为不同的互动迷你游戏。
基于文档的测验
“阅读此PDF并就关键概念对我进行测验”
克劳德从文档中提取事实，并创建有根据的测验问题。
自定义配置
“给我15个关于JavaScript闭包的硬真/假问题”
AI会根据您的要求调整问题数量、难度和类型组合。
发展
# Install dependencies
npm install
# Build everything (server + view)
npm run build
# Build only the view widget
npm run build:view
# Build only the server
npm run build:server
# Dev mode (auto-reload)
npm run dev
# Start HTTP server
npm start
# Start stdio server
npm run start:stdio
建筑
src/
index.ts — Express HTTP server (Streamable HTTP transport)
stdio.ts — Stdio server (Claude Desktop)
worker.ts — Cloudflare Worker entry point
quiz-server.ts — MCP server factory (tool + resource registration)
game-store.ts — In-memory session store with TTL
template-store.ts — Loads game templates from bundled files
types.ts — Shared TypeScript types
view/src/
QuizApp.tsx — Main MCP App component
components/ — React UI (QuizContainer, GameRuntime, EndScreen, etc.)
store/ — Zustand state management
hooks/ — postMessage communication hook
lib/ — Template injection utilities
templates/ — 125+ HTML canvas game templates
web/mcq/ — Desktop multiple-choice games
web/true-false/ — Desktop true/false games
mobile/mcq/ — Mobile multiple-choice games
mobile/true-false/ — Mobile true/false games
许可证
麻省理工学院
