Mcp Server Template V4w

🚀 MCP 服务器模板

本项目是一个专为构建 AI 工具而设计的、基于 Bun 运行时的_quiz_聚焦型 MCP 服务器启动套件，能助力开发者高效搭建相关服务器。

🚀 快速开始

本 MCP 服务器模板可帮助你快速搭建基于 Bun 运行时的 AI 工具服务器。以下是快速启动的基本步骤：

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

# 安装依赖项
bun install

# 启动服务器
bun start

✨ 主要特性

• 精准聚焦：专门针对_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

Claude 桌面设置

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

💻 使用示例

基础用法

运行服务器

# 启动服务器
bun start

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

测试

# 运行所有测试
bun test

高级用法

本服务器提供一个交互式测验工具 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

📚 详细文档

项目结构

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"),
// ...
});

📄 许可证

本项目采用 MIT 许可证。

致谢

该项目使用了由 Anthropic 开发的模型上下文协议（MCP），并提供了一个教育测验工具，供 AI 助手使用。