CURSOR25X - Interactive Task Loop MCP Server

📱 Social Media

🚀 CURSOR25X is an interactive task loop MCP (Model Context Protocol) server developed for Cursor IDE. It performs task-based operations by continuously receiving user input and develops modern web applications.

🎯 Features

• 🔄 Interactive Task Loop: Continuous task loop with user input
• 📝 Automatic File Management: Automatically creates `cursor25xinput.cjs` file
• 🌐 Web App Ready: Ready for modern web applications
• 📁 Smart Working Directory: Automatically detects Cursor workspace
• 🛑 Graceful Exit: Clean exit with "stop" command
• ⚡ Task Processing: Determines appropriate tasks based on input type
• 📋 Cursor Rules Integration: `.cursor/rules/cursor25x.mdc` rules

🚀 Quick Setup

1. Clone Repository

git clone https://github.com/tuncer-byte/cursor25x.git
cd cursor25x

2. Install Dependencies

npm install
npm run build

3. Integrate with Cursor IDE

Add the following to your `~/.cursor/mcp.json` file:

{
  "mcpServers": {
    "cursor25x": {
      "command": "node",
      "args": ["/path/to/cursor25x/dist/index.js"]
    }
  }
}

4. Start Using

In Cursor IDE:

1. Ctrl+Shift+P > "MCP: Connect to Server"

2. Select `cursor25x` server

3. Run `start_task_loop` tool

🔧 Usage

Main Tool: `start_task_loop`

One tool, maximum power!

// Run this tool in Cursor IDE:
mcp_cursor25x_start_task_loop()

What it does:

• 🔄 Starts interactive loop
• 📝 Creates `cursor25xinput.cjs`
• 📋 Creates `.cursor/rules/cursor25x.mdc` rules file
• 🖥️ Waits for user input in terminal
• ⚡ Processes tasks based on input

📊 Task Loop Workflow

graph TD
    A[Tool Started] --> B[Check Files]
    B --> C[Create cursor25xinput.cjs]
    C --> D[Create .cursor/rules/cursor25x.mdc]
    D --> E[Run Node Input Script]
    E --> F[Wait for User Input]
    F --> G{Input Type?}
    G -->|"create"| H[Create Task]
    G -->|"read"| I[Read Task]
    G -->|"update"| J[Update Task]
    G -->|"delete"| K[Delete Task]
    G -->|"help"| L[Help Task]
    G -->|"stop"| M[End Loop]
    H --> N[Return Result]
    I --> N
    J --> N
    K --> N
    L --> N
    N --> E

💡 Example Usage Commands

Create Web Application

🚀 CURSOR25X prompt: create a modern React web app with authentication

Code Review

🚀 CURSOR25X prompt: read and analyze the current project structure

Update

🚀 CURSOR25X prompt: update the package.json with latest dependencies

Help

🚀 CURSOR25X prompt: help

End Loop

🚀 CURSOR25X prompt: stop

🏗️ Project Structure

cursor25x/
├── src/
│   ├── index.ts              # Main MCP server
│   ├── interactive-loop.ts   # Task loop logic
│   ├── input-handler.ts      # Input processing
│   └── rules.ts             # Task rules
├── dist/                    # Compiled JavaScript
├── .cursor/
│   └── rules/
│       └── cursor25x.mdc    # Cursor IDE rules
├── cursor25xinput.cjs       # Interactive input handler
├── package.json
├── tsconfig.json
└── README.md

🛠️ Development

Run in Development Mode

npm run dev

Build

npm run build

Testing

# Test MCP server
node dist/index.js

🔧 Configuration

Working Directory

Server automatically determines working directory in this order:

1. `CURSOR_WORKSPACE` environment variable

2. `PWD` environment variable

3. `~/cursor25x` default directory

Cursor Rules

`.cursor/rules/cursor25x.mdc` file is automatically created and includes:

• Task loop workflow rules
• Input processing guide
• Error handling directives
• Usage examples

🌐 Web App Support

CURSOR25X is optimized for modern web application development:

• React/Vue/Angular projects
• Node.js backend development
• Database integration
• API development
• Authentication systems
• Modern UI/UX design

🚨 Troubleshooting

MCP Connection Error

# Check if server is running
ps aux | grep cursor25x

# Port check
netstat -an | grep LISTEN

Build Error

# Clean dependencies and reinstall
rm -rf node_modules package-lock.json
npm install
npm run build

Cursor Integration Error

1. Check `~/.cursor/mcp.json` file

2. Make sure paths are correct

3. Restart Cursor IDE

🤝 Contributing

1. Fork the project

2. Create feature branch (`git checkout -b feature/amazing-feature`)

3. Commit changes (`git commit -m 'Add amazing feature'`)

4. Push to branch (`git push origin feature/amazing-feature`)

5. Create Pull Request

📝 License

MIT License - see LICENSE file for details.

🎉 Credits

• Developer: tuncer-byte
• MCP SDK: @modelcontextprotocol/sdk
• Cursor IDE: Cursor

📞 Contact

• GitHub Issues: Issues
• Discussions: Discussions

🚀 Speed up your development workflow 25x with CURSOR25X!

*Designed for modern AI-powered development. Perfect harmony with Cursor IDE.*