MCP Server Template V4w

一個基於Bun運行時的MCP服務器模板，專門用於構建AI問答工具，提供多類別、多難度的交互式測驗功能。

教育與學習工具遊戲與遊戲化 #問答工具 #MCP協議 #Bun運行時 #測驗系統本地 .TypeScript

評分 : 2分

下載量 : 13

更新時間 : 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"),
  // ...
});