BitHighlander/nextjs-mcp-server
If you are the rightful owner of nextjs-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Motion Control Protocol (MCP) server implementation using Next.js, designed to integrate with Cursor as an external tool provider.
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
- Install dependencies:
npm install
- Run the development server:
npm run dev
- 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
- Base MCP endpoint:
Connecting with Cursor
To connect this MCP server with Cursor:
- Make sure your server is running (
npm run dev) - In Cursor, go to Settings > Tools > Motion Control Protocol
- Add a new MCP server with the URL:
http://localhost:3000 - The presence of a
mcp.jsonfile 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 househouse.getRooms- List all rooms (basic info)house.getRoom- Get details about a specific roomgetPassword- Get the password for accessing room 5resources.list- List all available resourcesresources.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.
