MCP Server Template V4w

🚀 MCP Server Template

A Bun runtime-specific, quiz-focused MCP server starter kit for building AI tools.

🚀 Quick Start

This MCP Server Template is designed to quickly build an AI - related quiz server. It has a series of features and functions, and the following will introduce its environment requirements, installation steps, usage methods, etc.

✨ Features

• A focused MCP server implementation specifically for quizzes.
• Quiz tools with multiple categories and difficulty levels.
• Jest test setup with MCP integration tests.
• Comprehensive test coverage.

📦 Installation

Environment Requirements

• Bun: v1.0.0 or higher.
  • Installation: https://bun.sh/docs/installation
• Node.js: v18.0.0 or higher (for some dependencies).
• Operating System:
  • macOS 12+
  • Linux glibc 2.31+
  • Windows 10+ (via WSL)

Installation Steps

# Clone the repository
git clone https://github.com/username/quiz-mcp-template.git
cd quiz-mcp-template

# Install dependencies
bun install

Claude Desktop Setup

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

💻 Usage Examples

Running the Server

# Start the server
bun start

# Development mode (with auto-restart)
bun dev

Testing

# Run all tests
bun test

MCP Tools

This server provides an interactive quiz tool:

get_quiz: Provides quiz questions of different categories and difficulty levels.

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

Available categories:

• general
• science
• history
• geography
• entertainment

Difficulty levels:

• easy
• medium
• hard

📚 Documentation

Project Structure

quiz-mcp-template/
├── src/
│   └── index.ts       # Main Quiz MCP server implementation file
├── tests/
│   └── cli-mcp.test.ts # MCP integration test file
├── package.json
├── tsconfig.json
└── README.md

Development - Extending Quiz Categories

To add new quiz categories or questions, modify the quizQuestions object in src/index.ts:

// Add a new category
quizQuestions.newCategory = {
  easy: [
    { question: "Easy question 1?", answer: "Answer 1" },
    { question: "Easy question 2?", answer: "Answer 2" },
    // Add more questions...
  ],
  medium: [
    { question: "Medium question 1?", answer: "Answer 1" },
    { question: "Medium question 2?", answer: "Answer 2" },
    // Add more questions...
  ],
  hard: [
    { question: "Hard question 1?", answer: "Answer 1" },
    { question: "Hard question 2?", answer: "Answer 2" },
    // Add more questions...
  ],
};

// Don't forget to update the schema to include the new category
const QuizSchema = z.object({
  category: z
    .enum([
      "general",
      "science",
      "history",
      "geography",
      "entertainment",
      "newCategory",
    ])
    .optional()
    .describe("The category of questions to ask"),
  // ...
});

📄 License

This project is licensed under the MIT License.

Acknowledgments

This project uses the Model Context Protocol (MCP) developed by Anthropic and provides an educational quiz tool for AI assistants.