Cursor25x
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.
Installation
npx cursor25xAsk AI about Cursor25x
Powered by Claude Β· Grounded in docs
I know everything about Cursor25x. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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.cjsfile - π 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.mdcrules
π 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:
- Ctrl+Shift+P > "MCP: Connect to Server"
- Select
cursor25xserver - Run
start_task_looptool
π§ 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.mdcrules 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:
CURSOR_WORKSPACEenvironment variablePWDenvironment variable~/cursor25xdefault 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
- Check
~/.cursor/mcp.jsonfile - Make sure paths are correct
- Restart Cursor IDE
π€ Contributing
- Fork the project
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - 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.
