MCP.so
Sign In

MCP Server Template

@tkc

About MCP Server Template

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

Basic information

Category

Developer Tools

Runtime

node

Transports

stdio

Publisher

tkc

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.

Comments

More Developer Tools MCP servers