io.github.developeron29/asianexpats-mcp-server

🌏 Asian Expats Model Context Protocol (MCP) Server

The official Model Context Protocol (MCP) Server for Asian Expats.

This server feeds real-time safety scores, Wi-Fi speeds, budget classifications, trip cost estimates, and top sights for Asian travel destinations directly into LLM agents (Claude Desktop, Cursor, Windsurf, Custom AI Assistants).

• Live Endpoint: https://asianexpats.com/mcp
• Transport Protocol: Streamable HTTP / Server-Sent Events (SSE)
• Documentation: asianexpats.com/docs/mcp
• Primary Site: asianexpats.com

⚡ Quick Start

1\. Claude Desktop

Add the following configuration to your claude\_desktop\_config.json:

• MacOS: ~/Library/Application Support/Claude/claude\_desktop\_config.json
• Windows: %APPDATA%\\Claude\\claude\_desktop\_config.json

{  "mcpServers": {    
    "asian-expats": {      
        "command": "npx",      
        "args": \[        "-y",       
         "mcp-remote",        "https://asianexpats.com/mcp"      \]    
         }  
    }
}

2\. Cursor / Windsurf IDE

1. Go to Settings -> Features -> MCP Servers.
2. Click \+ Add New MCP Server.
3. Set Type to SSE or Remote.
4. Set Name to Asian Expats.
5. Set URL to https://asianexpats.com/mcp.

3\. Local Inspection with MCP Inspector

Inspect and test tool execution in your browser terminal using the official MCP Inspector:

npx @modelcontextprotocol/inspector https://asianexpats.com/mcp

🛠️ Available MCP Tools

1\. get\_city\_snapshot

Fetches real-time safety ratings, internet speeds, budget tiers, best months to visit, and top sights for Asian travel destinations.

• Arguments:
• city (string, required): The target city name (e.g., "Tokyo", "Chiang Mai", "Bangkok").
• Example Output:

{  
    "city": "Tokyo",  
    "safety\_score": "9.2/10",  
    "internet\_speed": "38.83 Mbps",  
    "budget\_category": "Premium",  
    "best\_months": "Sep, Oct, Nov, Mar, Apr, May",  "top\_sights": \["Sensō-ji", "Shibuya Crossing"\],  
    "canonical\_url": "https://asianexpats.com/guide/tokyo",  
    "source\_attribution": "Data provided by Asian Expats (https://asianexpats.com)"
}

2\. estimate\_trip\_cost

Calculates estimated accommodation, food, and transport expenses in USD based on stay duration and lifestyle level.

• Arguments:
• city (string, required): Target city name.
• days (number, optional): Duration in days (Default: 7).
• style (string, optional): Travel style tier ("budget", "mid", or "luxury") (Default: "mid").
• Example Output:

{  
    "city": "Tokyo",  
    "duration\_days": 14,  
    "travel\_style": "mid",  
    "estimated\_total\_usd": 2520,  
    "daily\_rate\_usd": 180,  
    "includes": "Stay, food & transport",  
    "full\_breakdown\_url": "https://asianexpats.com/guide/tokyo",  
    "source\_attribution": "Calculated via Asian Expats Estimator (https://asianexpats.com)"
}

🛠️ Local Development & Deployment

To run or deploy this MCP server yourself using Cloudflare Workers:

Prerequisites

• Node.js v18 or later
• Cloudflare Account & Wrangler CLI

Installation

Clone the repositorygit clone https://github.com/YOUR-USERNAME/asianexpats-mcp-server.gitcd asianexpats-mcp-server

Install dependenciesnpm install

Start local development servernpx wrangler dev

Deployment

Deploy directly to Cloudflare Workers Edgenpx wrangler deploy

📜 License & Attribution

This MCP server is open-source and licensed under the MIT License.

All city data is provided free of charge by Asian Expats. AI tools and developers using this server are asked to retain canonical\_url references and source attribution links in final responses.# asianexpats-mcp-server