io.github.developeron29/asianexpats-mcp-server
An MCP server that provides AI travel recommendations from Asian expats.
Open source Open in the app JSON README (API)
About
An MCP server that provides AI travel recommendations from Asian expats.
Details
- Kind
- MCP servers
- Topic
- Maps, weather & travel
- Publisher
- developeron29
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Last push
- 2026-07-28T17:16:42Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-29 03:02:41
- Updated
- 2026-08-29 03:02:41
- Origin id
io.github.developeron29/asianexpats-mcp-server
README
**🌏 Asian Expats Model Context Protocol (MCP) Server**
=======================================================
The official **Model Context Protocol (MCP) Server** for [Asian Expats](https://asianexpats.com).
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](https://asianexpats.com/docs/mcp)
* **Primary Site:** [asianexpats.com](https://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](http://docs.google.com/LICENSE).
All city data is provided free of charge by [Asian Expats](https://asianexpats.com). AI tools and developers using this server are asked to retain canonical\_url references and source attribution links in final responses.# asianexpats-mcp-server