CURSOR25X is an interactive MCP server designed to run inside Cursor IDE. It establishes a continuous task loop that processes user prompts by selecting appropriate tasks (create, read, update, delete, or help) and generating results in real time. The server automatically prepares a dedicated input handler file (cursor25xinput.cjs) and a Cursor rules file (.cursor/rules/cursor25x.mdc) to guide the IDE integration, enabling a seamless workflow for building modern web applications. To start using it, connect to the server from Cursor IDE via the MCP: Connect to Server command, select cursor25x, and invoke the start_task_loop tool to begin an interactive session. During the loop, you can prompt the server with natural language requests to scaffold projects, review code, or update dependencies, and the server will respond with structured results and guidance.

Prerequisites:

• Node.js installed on your system (recommended LTS version)
• Access to a Cursor IDE environment for integration (optional but recommended)
• Internet access to install dependencies from npm

1. Clone the repository (or download the package): git clone https://github.com/tuncer-byte/cursor25x.git cd cursor25x

2. Install dependencies and build: npm install npm run build

3. Run the server (development parity): npm run dev

   or run the compiled server directly

   node dist/index.js

4. Integrate with Cursor IDE:

   • In Cursor IDE, add an MCP server entry pointing to the built server path, e.g.: command: node args: ["/path/to/cursor25x/dist/index.js"]

5. Optional: customize working directory or environment variables as needed (see Configuration section in README).

Tips and common issues:

• The server auto-detects its working directory in this order: CURSOR_WORKSPACE environment variable, PWD, then ~/cursor25x. If your project structure differs, set CURSOR_WORKSPACE accordingly.
• The first run creates cursor25xinput.cjs and .cursor/rules/cursor25x.mdc. Ensure you commit these to your workspace if needed.
• When configuring in Cursor IDE, ensure the path in args correctly points to dist/index.js after the build step.
• If you encounter MCP connection errors, verify that the server process is running and that the correct port is accessible by Cursor IDE.
• The server is designed for modern web app workflows (React/Vue/Angular) and Node.js backend development. It supports automatic task handling and can be extended with custom rules in cursor25x.mdc.