basicsu-courses-mcp

Access interactive programming courses from Basics directly in your Cursor IDE.

🚀 Quick Setup

Just run this command:

npx basicsu-courses-mcp setup

This will:

1. Ask for your Basics account email
2. Open your browser to sign in (no password needed!)
3. Automatically configure Cursor
4. You're ready to learn!

📚 Usage

After setup, restart Cursor and try these commands:

• "Start a React basics course" - Begin learning React
• "Show my course progress" - Check your progress
• "Next step" - Continue to the next lesson
• "Jump to lesson 3" - Skip to a specific lesson

🔧 Manual Configuration

If automatic setup doesn't work, you can configure manually:

1. Run the setup to get your device token:

   npx basicsu-courses-mcp setup

2. Add this to your Cursor MCP settings:

   {
     "mcpServers": {
       "basics-courses": {
         "command": "npx",
         "args": ["-y", "basicsu-courses-mcp@latest"],
         "env": {
           "BASICS_USER": "[email protected]",
           "BASICS_DEVICE": "your-device-token"
         }
       }
     }
   }

🔐 Security

• Your device token is unique and secure
• No passwords are stored anywhere
• You can revoke access anytime from your Basics account
• All course data stays on Basics servers

🐛 Troubleshooting

"Not authenticated" error

Run npx basicsu-courses-mcp setup again to re-authenticate.

Tools not showing in Cursor

1. Make sure you've restarted Cursor after setup
2. Check that the MCP server shows as "connected" in Cursor settings

Can't connect to courses

Check your internet connection - the MCP server needs to reach Basics servers.

📞 Support

• Website: basicsu.com
• Email: [email protected]
• Documentation: basicsu.com/docs

License

MIT © Basics Team