MCP Server Template V4w

一个基于Bun运行时的MCP服务器模板，专门用于构建AI问答工具，提供多类别、多难度的交互式测验功能。

教育与学习工具游戏与游戏化 #问答工具 #MCP协议 #Bun运行时 #测验系统本地 .TypeScript

评分 : 2分

下载量 : 11

更新时间 : 2025-04-23

什么是Quiz MCP Server?

Quiz MCP Server是一个专门为AI助手设计的知识问答服务，通过Model Context Protocol (MCP)提供交互式问答功能。它可以生成各种主题和难度级别的问题，帮助用户测试和扩展知识。

如何使用Quiz MCP Server?

您可以通过AI助手(如Claude)直接调用该服务，选择感兴趣的主题和难度级别，系统会返回相应的问题和答案。

适用场景

适用于知识学习、教育娱乐、团队建设活动、个人知识测试等多种场景。

主要功能

多类别问答提供科学、历史、地理、娱乐等多个知识领域的问答

难度分级每个类别的问题分为简单、中等和困难三个难度级别

易于集成通过标准MCP协议与各种AI助手无缝集成

优势与局限性

优势

提供丰富多样的知识问答内容

支持多种难度级别，适合不同水平的用户

易于与现有AI系统集成

响应快速，性能稳定

局限性

目前问题库有限，需要定期更新

不支持自定义问题添加(需开发人员扩展)

需要基本的命令行知识进行初始设置

如何使用

安装必要的软件

确保您的系统已安装Bun运行时(v1.0.0+)和Node.js(v18.0.0+)

克隆并设置项目

从GitHub获取项目代码并安装依赖

配置AI助手

在AI助手设置中添加服务器路径和启动命令

启动服务器

运行服务器开始使用问答功能

使用案例

学习科学知识用户想测试自己的科学知识水平

娱乐问答游戏朋友聚会时进行知识问答游戏

历史知识复习学生复习历史考试内容

常见问题

如何添加新的问题类别?

支持哪些操作系统?

如何测试服务是否正常工作?

问题库会定期更新吗?

🚀 MCP 服务器模板

用于构建 AI 工具的 Bun 运行时专用_quiz_聚焦型 MCP 服务器启动套件，助力快速搭建测验服务器

🚀 快速开始

本 MCP 服务器模板专为构建 AI 工具的 Bun 运行时打造，是_quiz_聚焦型的启动套件。借助它，你可以快速搭建一个具备测验功能的 MCP 服务器。

✨ 主要特性

专门针对_quiz_的聚焦型 MCP 服务器实现，精准满足测验需求。
具备多个类别和难度级别的测验工具，涵盖多种知识领域。
带有 MCP 集成测试的 Jest 测试设置，保证代码质量。
全面的测试覆盖范围，让你的项目更加稳定可靠。

📦 安装指南

环境要求

Bun: v1.0.0 或更高版本
- 安装：https://bun.sh/docs/installation
Node.js: v18.0.0 或更高版本（用于某些依赖项）
操作系统:
- macOS 12+
- Linux glibc 2.31+
- Windows 10+（通过 WSL）

安装步骤

# 克隆仓库
git clone https://github.com/username/quiz-mcp-template.git
cd quiz-mcp-template

# 安装依赖项
bun install

💻 使用示例

基础用法

运行服务器

# 启动服务器
bun start

# 开发模式（带自动重启）
bun dev

测试

# 运行所有测试
bun test

高级用法

MCP 工具使用

此服务器提供一个交互式测验工具： get_quiz: 提供不同类别和难度级别的测验问题

{
  "method": "tools/call",
  "params": {
    "name": "get_quiz",
    "arguments": {
      "category": "science",
      "difficulty": "medium"
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

可用类别：

general
science
history
geography
entertainment

难度级别：

easy
medium
hard

📚 详细文档

Claude 桌面设置

{
  "quiz": {
    "command": "<your path>/.bun/bin/bun",
    "args": ["run", "<your path>/bun-mcp-template/src/index.ts"]
  }
}

项目结构

quiz-mcp-template/
├── src/
│   └── index.ts       # 主 Quiz MCP 服务器实现文件
├── tests/
│   └── cli-mcp.test.ts # MCP 集成测试文件
├── package.json
├── tsconfig.json
└── README.md

开发

扩展测验类别

要添加新的测验类别或问题，请修改 src/index.ts 中的 quizQuestions 对象：

// 添加新类别
quizQuestions.newCategory = {
  easy: [
    { question: "Easy question 1?", answer: "Answer 1" },
    { question: "Easy question 2?", answer: "Answer 2" },
    // 添加更多问题...
  ],
  medium: [
    { question: "Medium question 1?", answer: "Answer 1" },
    { question: "Medium question 2?", answer: "Answer 2" },
    // 添加更多问题...
  ],
  hard: [
    { question: "Hard question 1?", answer: "Answer 1" },
    { question: "Hard question 2?", answer: "Answer 2" },
    // 添加更多问题...
  ],
};

// 不要忘记更新模式来包含新类别
const QuizSchema = z.object({
  category: z
    .enum([
      "general",
      "science",
      "history",
      "geography",
      "entertainment",
      "newCategory",
    ])
    .optional()
    .describe("The category of questions to ask"),
  // ...
});