MCP-Next.js

Overview

MCP-Next.js is a reference implementation of an MCP server built with Next.js and TypeScript. It demonstrates how to create and expose multiple interactive tools through a standardized JSON-RPC API. The server includes 8 different tools ranging from simple utilities like dice rolling and number generation to more creative features like random quotes and horoscopes. This implementation uses mcp-handler and @modelcontextprotocol/sdk to establish the MCP protocol interface, making it a good learning resource for developers looking to implement MCP servers.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• roll_dice

  Roll an N-sided die.

  Try:Roll a 6-sided dieTry:Roll a 20-sided die
• say_hello

  Returns a greeting message.

  Try:Say hello to JohnTry:Greet the user
• add_numbers

  Adds two numbers.

  Try:Add 10 and 15Try:What is 7 plus 3?
• random_number

  Generates a random number between a given min and max.

  Try:Generate a random number between 1 and 100Try:Get a random number between 5 and 15
• random_quote

  Returns a motivational quote.

  Try:Give me a random quoteTry:Show me an inspirational quote
• emoji_reaction

  Responds with a random emoji.

  Try:React with an emojiTry:Show me a random emoji reaction
• color_palette

  Generates a random color palette.

  Try:Generate a color palette with 5 colorsTry:Create a random color scheme
• horoscope

  Returns a fun horoscope for a zodiac sign.

  Try:What's the horoscope for Leo?Try:Show me today's horoscope for Aries

Comparable tools

Installation

# Clone the repository
git clone https://github.com/sattarrasouli/MCP-Next.js.git
cd MCP-Next.js

# Install dependencies
npm install

# Run the development server
npm run dev

{
  "mcpServers": {
    "mcp-nextjs": {
      "command": "npm",
      "args": ["run", "dev"],
      "env": {
        "NODE_PATH": "."
      }
    }
  }
}

FAQ

What MCP servers does this project implement?

This project implements a simple MCP server with 8 tools: Roll Dice, Say Hello, Add Numbers, Random Number, Random Quote, Emoji Reaction, Color Palette, and Horoscope.

How do I test the MCP tools?

You can test the tools using either Postman or curl with JSON-RPC 2.0 format. The API endpoint is available at http://localhost:3000/api/mcp when running the development server.

Compare MCP-Next.js with