NS-Rideshare

Community rideshare platform for Singapore <-> Forest City (Johor Bahru) commuters. 400+ users, 30+ rides per month.

Website: ns-rideshare.com | Docs: ns-rideshare.com/docs

Use via Claude Code (MCP)

The best way to use NS-Rideshare is through Claude Code. No UI needed. Just chat.

Quick Install

Add this to your ~/.mcp.json (or project .mcp.json):

{
  "mcpServers": {
    "ns-rideshare": {
      "command": "node",
      "args": ["<path-to-repo>/mcp-server/dist/index.js"],
      "env": {
        "NS_USER": "<your-discord-username>"
      }
    }
  }
}

Setup

# Clone and build
git clone https://github.com/phuaky/NS-RIDESHARE.git
cd NS-RIDESHARE/mcp-server
npm install && npm run build

Then restart Claude Code. You can now:

• "Find rides to Forest City this weekend"
• "Create a ride to SG on Saturday 8am"
• "Join ride #123"
• "Show my upcoming rides"
• "List available drivers"

MCP Tools

Tool	What it does
find_rides	Search available rides by direction and date
create_ride	Create a new ride
join_ride	Join an existing ride
my_rides	List your upcoming rides
book_driver	Assign a driver from the roster
list_drivers	Show available drivers

Tech Stack

Layer	Stack
Frontend	React 18 + Vite + TailwindCSS + Shadcn UI
Backend	Hono on Cloudflare Workers
Database	NeonDB (PostgreSQL)
Auth	JWT + httpOnly cookies
Hosting	Cloudflare Pages + Workers (zero cost)
MCP	Model Context Protocol server for Claude Code

Development

# Frontend
cd client && npm run dev

# Backend
cd worker && wrangler dev

# MCP server
cd mcp-server && npm run build

# Deploy frontend
npx vite build && wrangler pages deploy dist/public --project-name=ns-rideshare

# Deploy backend
cd worker && wrangler deploy

API

Full API docs at ns-rideshare.com/docs (API tab).

All endpoints under https://api.ns-rideshare.com/api/.

Contributing

PRs welcome. If anything breaks, open an issue.