MCP Server Template

@tkc

About MCP Server Template

MCP starter kit for building AI tools with Bun runtime - specialized for interactive quizzes

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-template-tkc": {
      "command": "bun",
      "args": [
        "start"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Server Template?

MCP Server Template is a starter kit for building AI tools with the Bun runtime, specifically providing a specialized quiz-focused Model Context Protocol (MCP) server implementation. It is intended for developers who want to create interactive quiz tools integrated with AI assistants via the MCP protocol.

How to use MCP Server Template?

Clone the repository, install dependencies with bun install, then run the server using bun start (production) or bun dev (development with auto-restart). For Claude Desktop integration, add a JSON entry specifying the Bun command and path to the server entry point (src/index.ts).

Key features of MCP Server Template

Specialized quiz-focused MCP server implementation
Quiz tool with multiple categories (general, science, history, geography, entertainment)
Three difficulty levels: easy, medium, hard
Jest testing setup with MCP integration tests
Comprehensive test coverage

Use cases of MCP Server Template

Build educational quiz tools for AI assistants using MCP
Integrate multi-category, multi-difficulty quizzes into Claude Desktop
Extend the template with custom quiz categories and questions for domain-specific learning
Test MCP server implementations with a ready-made Jest test suite

FAQ from MCP Server Template

What are the runtime requirements for MCP Server Template?

Bun v1.0.0 or higher is required; Node.js v18.0.0+ is needed for some dependencies. Supported operating systems are macOS 12+, Linux with glibc 2.31+, and Windows 10+ (via WSL).

How do I add new quiz categories?

Modify the quizQuestions object in src/index.ts by adding a new key with arrays for each difficulty level, then update the QuizSchema enum to include the new category name.

What tests are available and how do I run them?

The project includes Jest integration tests located in tests/cli-mcp.test.ts. Run all tests with bun test.

What MCP tools does the server provide?

The server provides one tool called get_quiz, which accepts a category and difficulty argument and returns quiz questions from the specified category and difficulty level.

How do I configure MCP Server Template with Claude Desktop?

Add an entry to your Claude Desktop configuration JSON with command set to the Bun binary path and args containing ["run", "<full path to src/index.ts>"]. The server is then available as an MCP tool.

Frequently asked questions

What are the runtime requirements for MCP Server Template?

Bun v1.0.0 or higher is required; Node.js v18.0.0+ is needed for some dependencies. Supported operating systems are macOS 12+, Linux with glibc 2.31+, and Windows 10+ (via WSL).

How do I add new quiz categories?

Modify the `quizQuestions` object in `src/index.ts` by adding a new key with arrays for each difficulty level, then update the `QuizSchema` enum to include the new category name.

What tests are available and how do I run them?

The project includes Jest integration tests located in `tests/cli-mcp.test.ts`. Run all tests with `bun test`.

What MCP tools does the server provide?

The server provides one tool called `get_quiz`, which accepts a `category` and `difficulty` argument and returns quiz questions from the specified category and difficulty level.

How do I configure MCP Server Template with Claude Desktop?

Add an entry to your Claude Desktop configuration JSON with `command` set to the Bun binary path and `args` containing `["run", "<full path to src/index.ts>"]`. The server is then available as an MCP tool.

Comments

Basic information

More Developer Tools MCP servers

discoverGPT

Joe Monastiero

discoverGPT is visualAI's unified MCP gateway for AI commerce, exposing 29 tools across four capabilities on one canonical product catalog: trimodal search (natural-language, precise-color, and image-similarity), AI cata

Sentry

modelcontextprotocol

Model Context Protocol Servers

88.1K

Reelier

Maxime Houle

Agents make claims. Reelier writes receipts — record an agent's tool-call workflow once, replay it deterministically at 0 tokens, and diff runs to catch drift.

MCP Inspector

modelcontextprotocol

Visual testing tool for MCP servers

10.3K

endoflife.ai

Free MCP server for software end-of-life intelligence: EOL dates, support status, and the 0-100 EOL Risk Score across 485 tracked products. Agents can check a single version, pull a product's full lifecycle schedule, or