A Motion Control Protocol (MCP) server implementation using Next.js. This server can be integrated with Cursor as an external tool provider.
- 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
- 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:
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
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
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
MIT
This is a Next.js project bootstrapped with create-next-app.
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!
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.