# TravelMind MCP Server

TravelMind (差旅 + 报销 + AI Agent 一体化) 的官方 MCP (Model Context Protocol) server。

让任意 MCP 兼容客户端(Claude Desktop / Cursor / WorkBuddy / 等)直接调用中国境内的差旅核心能力:地理编码、POI 搜索、周边搜索和反向地理编码。

## Features

4 个核心 Tools,全部由高德开放 API 提供实时数据:

| Tool | Description | API |
|---|---|---|
| `geocode` | 地址 → 经纬度 (城市/地址解析) | `/v3/geocode/geo` |
| `regeocode` | 经纬度 → 行政区 + POI (逆地理编码) | `/v3/geocode/regeo` |
| `text_search` | 关键词搜 POI (酒店/餐厅/景点) | `/v3/place/text` |
| `around_search` | 周边搜 POI (坐标 + radius) | `/v3/place/around` |

## Quick Start

### Prerequisites
- Node.js >= 18
- 高德开放平台 API Key: https://lbs.amap.com/dev/key/app

### Install
```bash
git clone https://github.com/gcszkjpzzv-beep/TravelMind_MCP.git
cd TravelMind_MCP
npm install
```

### Configure
```bash
export AMAP_API_KEY="your-amap-api-key"
```

### Run
```bash
node index.js
```

### Use in Claude Desktop / Cursor
```json
{
  "mcpServers": {
    "travelmind": {
      "command": "node",
      "args": ["/path/to/TravelMind_MCP/index.js"],
      "env": { "AMAP_API_KEY": "your-key" }
    }
  }
}
```

## Tools Reference

### geocode
```json
{
  "address": "北京市朝阳区望京 SOHO",
  "city": "北京"
}
```
Returns `{ location: "lng,lat", formatted_address, ... }`.

### regeocode
```json
{ "location": "116.481,39.990" }
```
Returns `{ formatted_address, addressComponent: { province, city, district, ... } }`.

### text_search
```json
{
  "keywords": "希尔顿酒店",
  "city": "北京",
  "types": "住宿"
}
```
Returns `{ pois: [{ id, name, address, location, ... }] }`.

### around_search
```json
{
  "keywords": "餐厅",
  "location": "116.481,39.990",
  "radius": "1000"
}
```
Returns `{ pois: [...] }` within radius.

## About TravelMind

- Official site: https://www.trvaelmind.online
- ICP: 浙ICP备2026021219号

## License

MIT