{"_id":"@aravb09/basics-courses","_rev":"3-5f08c4137b7e2d6eed597d0b103f47c6","name":"@aravb09/basics-courses","dist-tags":{"latest":"1.3.25"},"versions":{"1.3.24":{"name":"@aravb09/basics-courses","version":"1.3.24","keywords":["mcp","cursor","ai","learning","programming","courses"],"author":{"name":"Basics Team"},"license":"MIT","_id":"@aravb09/basics-courses@1.3.24","maintainers":[{"name":"aravb09","email":"aravb09@gmail.com"}],"homepage":"https://github.com/basicsu/basicsu-courses-mcp#readme","bugs":{"url":"https://github.com/basicsu/basicsu-courses-mcp/issues"},"bin":{"basics-courses":"dist/stdio.js"},"dist":{"shasum":"616f2c6898b60be9e50345fef9585459aebaa170","tarball":"https://registry.npmjs.org/@aravb09/basics-courses/-/basics-courses-1.3.24.tgz","fileCount":178,"integrity":"sha512-nfc8PoU2xq+lyARun+Fu0o0gvY7j7Q6eVHsH/lZlkUXXeS0EGP1+QF4f5HoOeFQlU0RIVMWyCKERUYyqAQmNew==","signatures":[{"sig":"MEYCIQDPjco6gaaIyTyiBHvmCPMsigFadHulhZgTKOxf2woe4wIhAJ8caehSBqdPME5BrOCkYLD/l9H28Uct3QUw28GWDJ0S","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":682037},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"2e78b529d5d54ea9722824e815f621adb4e8cd84","scripts":{"dev":"tsc --watch","build":"tsc && chmod +x dist/stdio.js","start":"node dist/stdio.js --transport http --port $PORT","prepare":"npm run build","test:local":"node dist/stdio.js"},"_npmUser":{"name":"aravb09","email":"aravb09@gmail.com"},"repository":{"url":"git+https://github.com/basicsu/basicsu-courses-mcp.git","type":"git"},"_npmVersion":"11.4.2","description":"Interactive programming courses from Basics - MCP server for Cursor","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^3.25.76","cors":"^2.8.5","convex":"^1.27.3","dotenv":"^17.2.0","nanoid":"^5.0.4","express":"^4.18.2","ioredis":"^5.4.1","postgres":"^3.4.7","commander":"^14.0.0","drizzle-orm":"^0.44.5","@types/ioredis":"^4.28.10","zod-to-json-schema":"^3.24.6","@supabase/supabase-js":"^2.52.0","@modelcontextprotocol/sdk":"^1.17.5"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/cors":"^2.8.13","@types/node":"^20.11.24","drizzle-kit":"^0.31.5","@types/express":"^4.17.17"},"_npmOperationalInternal":{"tmp":"tmp/basics-courses_1.3.24_1759036664162_0.4029998165401312","host":"s3://npm-registry-packages-npm-production"}},"1.3.25":{"name":"@aravb09/basics-courses","version":"1.3.25","keywords":["mcp","cursor","ai","learning","programming","courses"],"author":{"name":"Basics Team"},"license":"MIT","_id":"@aravb09/basics-courses@1.3.25","maintainers":[{"name":"aravb09","email":"aravb09@gmail.com"}],"homepage":"https://github.com/basicsu/basicsu-courses-mcp#readme","bugs":{"url":"https://github.com/basicsu/basicsu-courses-mcp/issues"},"bin":{"basics-courses":"dist/stdio.js"},"dist":{"shasum":"fb0e3c8353187633a9e2ee7e18b00089df20a8e5","tarball":"https://registry.npmjs.org/@aravb09/basics-courses/-/basics-courses-1.3.25.tgz","fileCount":178,"integrity":"sha512-AasIECJCrPtOcRP0YOqUvl7yFuAoPuq+XHDebOqiAgxqsnMRLj37aarE6h4RgWo+OFdJdwJc/AMuDll9uErXZQ==","signatures":[{"sig":"MEUCIBf8J9xspuFPJQDEloSLg+EKLs/kuttE5vZZOlnsVxLFAiEAvN1k7PhZwbsx5reY2TK4GYXN7Ye2/I0AF+TMWHpo1AU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":682065},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"342c8ceedd59975cd3750d119d45eecbc80492f8","scripts":{"dev":"tsc --watch","build":"tsc && chmod +x dist/stdio.js","start":"node dist/stdio.js --transport http --port $PORT","prepare":"npm run build","test:local":"node dist/stdio.js"},"_npmUser":{"name":"aravb09","email":"aravb09@gmail.com"},"repository":{"url":"git+https://github.com/basicsu/basicsu-courses-mcp.git","type":"git"},"_npmVersion":"11.4.2","description":"Interactive programming courses from Basics - MCP server for Cursor","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^3.25.76","cors":"^2.8.5","convex":"^1.27.3","dotenv":"^17.2.0","nanoid":"^5.0.4","express":"^4.18.2","ioredis":"^5.4.1","postgres":"^3.4.7","commander":"^14.0.0","drizzle-orm":"^0.44.5","@types/ioredis":"^4.28.10","zod-to-json-schema":"^3.24.6","@supabase/supabase-js":"^2.52.0","@modelcontextprotocol/sdk":"^1.17.5"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/cors":"^2.8.13","@types/node":"^20.11.24","drizzle-kit":"^0.31.5","@types/express":"^4.17.17"},"_npmOperationalInternal":{"tmp":"tmp/basics-courses_1.3.25_1759036863835_0.13396113242985397","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-09-28T05:17:44.088Z","modified":"2026-06-09T06:18:32.116Z","1.3.24":"2025-09-28T05:17:44.364Z","1.3.25":"2025-09-28T05:21:04.202Z"},"bugs":{"url":"https://github.com/basicsu/basicsu-courses-mcp/issues"},"author":{"name":"Basics Team"},"license":"MIT","homepage":"https://github.com/basicsu/basicsu-courses-mcp#readme","keywords":["mcp","cursor","ai","learning","programming","courses"],"repository":{"url":"git+https://github.com/basicsu/basicsu-courses-mcp.git","type":"git"},"description":"Interactive programming courses from Basics - MCP server for Cursor","maintainers":[{"email":"aravb09@gmail.com","name":"aravb"}],"readme":"# @basicsu/courses-mcp\n\nAccess interactive programming courses from Basics directly in your Cursor IDE using the Model Context Protocol (MCP).\n\n## ✨ Zero Configuration Required!\n\n**Just install and use** - no API keys, no environment variables, no setup needed!\n\nThe MCP server includes built-in publishable keys that are safe to use. These keys are protected by Row Level Security (RLS) in Supabase, ensuring users can only access appropriate course content.\n\n## 🚀 Quick Setup\n\n### Method 1: Full NPX Path (Recommended)\n\n1. Find your full NPX path:\n   ```bash\n   which npx\n   ```\n\n2. Add to your Cursor MCP settings:\n   ```json\n   {\n     \"mcpServers\": {\n       \"basics-courses\": {\n         \"command\": \"/opt/homebrew/bin/npx\",\n         \"args\": [\"@basicsu/courses-mcp@latest\"]\n       }\n     }\n   }\n   ```\n\n### Method 2: Direct Node (Most Reliable)\n\n1. Install globally:\n   ```bash\n   npm install -g @basicsu/courses-mcp@latest\n   ```\n\n2. Find your paths:\n   ```bash\n   which node\n   npm root -g\n   ```\n\n3. Add to your Cursor MCP settings:\n   ```json\n   {\n     \"mcpServers\": {\n       \"basics-courses\": {\n         \"command\": \"/opt/homebrew/bin/node\",\n         \"args\": [\"/opt/homebrew/lib/node_modules/@basicsu/courses-mcp/dist/stdio.js\"]\n       }\n     }\n   }\n   ```\n\n## 📚 Usage\n\n1. **Get your auth code** from [basicsu.com/settings/account](https://basicsu.com/settings/account)\n2. **Restart Cursor** completely\n3. **Switch to Agent mode** (not Composer)\n4. **Start learning**:\n   - `\"Please use the startBasics tool to help me learn programming\"`\n   - `\"Please use startBasics to start the mastra course\"`\n   - `\"Please use nextBasicsCourseStep to continue\"`\n   - `\"Please use getBasicsCourseStatus to check my progress\"`\n\n## 🔧 Available Tools\n\n- **`startBasics`** - Authenticate and start courses\n- **`nextBasicsCourseStep`** - Continue to next step\n- **`getBasicsCourseStatus`** - Check your progress\n- **`startBasicsCourseLesson`** - Jump to specific lesson\n- **`clearBasicsCourseHistory`** - Reset course progress\n\n## 🐛 Troubleshooting \"Zero Tools Available\"\n\n### Most Common Issue: Cursor can't find `npx`\n\n**Solution**: Use full paths instead of relative commands.\n\n### Why This Happens\n- Cursor's GUI environment doesn't inherit your shell's PATH\n- `npx` isn't found, causing `spawn npx ENOENT` errors\n- Server appears connected but tools never register\n\n### Debugging Steps\n1. **Test manually**: Run `npx @basicsu/courses-mcp@1.1.38` in terminal\n2. **Check paths**: Run `which node` and `which npx`\n3. **Use Agent mode**: Switch to Agent mode in Cursor\n4. **Restart fully**: Close Cursor completely and reopen\n5. **Verify tools**: Should see 5 tools listed (not just green connection)\n\n### Common Paths by System\n- **Mac (Homebrew)**: `/opt/homebrew/bin/npx`, `/opt/homebrew/bin/node`\n- **Mac (Node.js)**: `/usr/local/bin/npx`, `/usr/local/bin/node`\n- **Linux**: `/usr/bin/npx`, `/usr/bin/node`\n- **Windows**: `C:\\\\Program Files\\\\nodejs\\\\npx.cmd`\n\n## 🔐 Authentication\n\n1. Visit [basicsu.com/settings/account](https://basicsu.com/settings/account)\n2. Copy your MCP Auth Code\n3. When prompted in Cursor, provide:\n   - Your email address\n   - Your auth code\n4. Progress is automatically synced with your account\n\n## 📞 Support\n\n- **Website**: [basicsu.com](https://basicsu.com)\n- **Documentation**: [basicsu.com/docs](https://basicsu.com/docs)\n- **GitHub Issues**: [Report bugs and issues](https://github.com/basicsu/basicsu-courses-mcp/issues)\n\n## License\n\nMIT © Basics Team","readmeFilename":"README.md"}