MCP 服务器模板

使用 Bun 运行时构建 AI 工具的 MCP 启动套件

环境要求

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

特性

• 专门针对测验的 MCP 服务器实现
• 具有多个类别和难度级别的测验工具
• 带有 MCP 集成测试的 Jest 测试设置
• 全面的测试覆盖率

安装

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

# 安装依赖
bun install

Claude Desktop 设置

{
  "quiz": {
    "command": "<你的路径>/.bun/bin/bun",
    "args": ["run", "<你的路径>/bun-mcp-template/src/index.ts"]
  }
}

使用方法

运行服务器

# 启动服务器
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 (困难)

项目结构

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

开发

扩展测验类别

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

// 添加新类别
quizQuestions.newCategory = {
  easy: [
    { question: "简单问题 1?", answer: "答案 1" },
    { question: "简单问题 2?", answer: "答案 2" },
    // 添加更多问题...
  ],
  medium: [
    { question: "中等问题 1?", answer: "答案 1" },
    { question: "中等问题 2?", answer: "答案 2" },
    // 添加更多问题...
  ],
  hard: [
    { question: "困难问题 1?", answer: "答案 1" },
    { question: "困难问题 2?", answer: "答案 2" },
    // 添加更多问题...
  ],
};

// 不要忘记更新 schema 以包含新类别
const QuizSchema = z.object({
  category: z
    .enum([
      "general",
      "science",
      "history",
      "geography",
      "entertainment",
      "newCategory",
    ])
    .optional()
    .describe("要提问的问题类别"),
  // ...
});

许可证

MIT

致谢

本项目使用了 Anthropic 开发的 Model Context Protocol (MCP)，并为 AI 助手提供了一个教育性的测验工具。