What is Nextjs Mcp Server

Next.js MCP Server is an implementation of a Motion Control Protocol (MCP) server using Next.js, designed to be integrated with Cursor as an external tool provider.

Use cases

Use cases for Next.js MCP Server include managing smart home devices, providing real-time updates in interactive applications, and facilitating communication between various tools and services in a motion control context.

How to use

To use the Next.js MCP Server, install the dependencies with ‘npm install’, then run the development server using ‘npm run dev’. The server will be accessible at ‘http://localhost:3000/api/mcp’ for the MCP endpoint and ‘http://localhost:3000/’ for SSE connections.

Key features

Key features include Server-Sent Events (SSE) for real-time communication, a JSON-RPC compliant API for tool invocation, a house exploration example with rooms, items, and resources, and compatibility with Cursor’s MCP requirements.

Where to use

Next.js MCP Server can be used in applications that require real-time communication and tool management, particularly in smart home systems, robotics, and interactive environments.

Next.js MCP Server

A Motion Control Protocol (MCP) server implementation using Next.js. This server can be integrated with Cursor as an external tool provider.

Features

• Server-Sent Events (SSE) for real-time communication
• JSON-RPC compliant API for tool invocation
• House exploration example with rooms, items, and resources
• Compatible with Cursor’s MCP requirements

Getting Started

1. Install dependencies:

npm install

2. Run the development server:

npm run dev

3. The MCP server will be running at:
   • Base MCP endpoint: http://localhost:3000/api/mcp
   • SSE connection: http://localhost:3000/
   • Message endpoint: http://localhost:3000/api/message

Connecting with Cursor

To connect this MCP server with Cursor:

1. Make sure your server is running (npm run dev)
2. In Cursor, go to Settings > Tools > Motion Control Protocol
3. Add a new MCP server with the URL: http://localhost:3000
4. The presence of a mcp.json file in the root directory will help Cursor recognize this as an MCP server

Available Tools

The server provides the following tools:

• house.getDetails - Get general information about the house
• house.getRooms - List all rooms (basic info)
• house.getRoom - Get details about a specific room
• getPassword - Get the password for accessing room 5
• resources.list - List all available resources
• resources.get - Get a specific resource by ID

Implementation Details

This MCP server is based on Next.js App Router and uses:

• API Routes for JSON-RPC endpoints
• Server-Sent Events for real-time communication
• Next.js streaming responses
• TypeScript for type safety

License

MIT

This is a Next.js project bootstrapped with create-next-app.

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.