bamikalea/mobility-mcp-africa

Africa's first open-standard MCP server for ride-hailing. Enables AI agents to search, book, and manage rides via the Model Context Protocol. # mobility-mcp-africa Africa's first open-standard MCP server for ride-hailing. Enables AI agents (Claude, GPT, Gemini) to search, book, and manage rides via the Model Context Protocol. ## Why This Exists The travel industry is shifting to AI agent-based booking. Google, Booking.com, and Expedia are building agents that book travel on behalf of users. These agents need standardized APIs to connect to — and MCP is that standard. **No ride-hailing provider in Africa currently has an MCP-compatible API.** This project changes that by providing: 1. A **generic provider interface** that any ride-hailing service (Bolt, Uber, InDrive, local operators, etc.) can implement 2. A **working MCP server** with tools for searching, booking, tracking, and cancelling rides 3. A **mock provider** with realistic Nigerian data for development and demos 4. A **live provider** template for connecting to any ride-hailing service's REST API ## Architecture ``` AI Agent (Claude, GPT, Gemini, etc.) | | MCP Protocol (stdio) v +---------------------------+ | mobility-mcp-africa | | (MCP Server) | | | | 10 Tools + 2 Resources | | | | Provider Abstraction | | ├── MockProvider (dev) | | ├── LiveProvider (prod) | | └── YourProvider (add!) | +---------------------------+ | | REST API v Ride-Hailing Provider API ``` ## Quick Start ### Install ```bash git clone github.com cd mobility-mcp-africa npm install ``` ### Run with Mock Provider ```bash # No API keys needed — uses realistic Lagos mock data PROVIDER=mock npx tsx src/index.ts ``` ### Test with MCP Inspector ```bash npx @modelcontextprotocol/inspector npx tsx src/index.ts ``` This opens a web UI where you can test all tools interactively. ### Use with Claude Desktop Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS): ```json { "mcpServers": { …