asianexpats-mcp-server

🌏 Asian Expats Model Context Protocol (MCP) 服务

Asian Expats 的官方 Model Context Protocol (MCP) 服务。

此服务会将亚洲旅行目的地的实时安全评分、Wi-Fi 速度、预算分类、旅行费用估算和热门景点直接提供给大模型 Agent（Claude Desktop、Cursor、Windsurf、自定义 AI 助手）。

• 实时端点： https://asianexpats.com/mcp

• 传输协议： Streamable HTTP / Server-Sent Events (SSE)

• 文档： asianexpats.com/docs/mcp

• 主站： asianexpats.com

⚡ 快速开始

1. Claude Desktop

将以下配置添加到 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. 前往 Settings -> Features -> MCP Servers。

2. 点击 + Add New MCP Server。

3. 将 Type 设为 SSE 或 Remote。

4. 将 Name 设为 Asian Expats。

5. 将 URL 设为 https://asianexpats.com/mcp。

3. 使用 MCP Inspector 在本地检查

使用官方 MCP Inspector，在浏览器终端中检查并测试工具执行情况：

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

🛠️ 可用的 MCP 工具

1. get_city_snapshot

获取亚洲旅行目的地的实时安全评级、网速、预算档次、最佳旅行月份和热门景点。

• 参数：

• city (string, required)：目标城市名称（例如，“Tokyo”“Chiang Mai”“Bangkok”）。

• 输出示例：

{  
    "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

根据住宿时长和生活方式档次，估算住宿、餐饮和交通费用（以 USD 计）。

• 参数：

• city (string, required)：目标城市名称。

• days (number, optional)：天数（默认值：7）。

• style (string, optional)：旅行风格档次（“budget”“mid”或“luxury”）（默认值：“mid”）。

• 输出示例：

{  
    "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)"
}

🛠️ 本地开发与部署

如需使用 Cloudflare Workers 运行或部署此 MCP 服务：

前提条件

• Node.js v18 或更高版本

• Cloudflare 账户和 Wrangler CLI

安装

克隆仓库git clone https://github.com/YOUR-USERNAME/asianexpats-mcp-server.gitcd asianexpats-mcp-server

安装依赖npm install

启动本地开发服务器npx wrangler dev

部署

直接部署到 Cloudflare Workers Edgenpx wrangler deploy

📜 许可证与署名

此 MCP 服务为开源项目，采用 MIT License 授权。

所有城市数据均由 Asian Expats 免费提供。使用此服务的 AI 工具和开发者应在最终回复中保留 canonical_url 引用和来源署名链接。# asianexpats-mcp-server