使用说明
🌍 旅行计划MCP服务器
基于模型上下文协议（MCP）构建的智能出行规划代理系统。
快速开始
先决条件
- Docker已安装
- Claude桌面应用程序
安装
- 拉取Docker镜像
docker pull YOUR_DOCKERHUB_USERNAME/travel-planner-mcp:latest
- 配置Claude桌面
编辑您的Claude Desktop配置文件：
- 苹果电脑:
~/Library/Application Support/Claude/claude_desktop_config.json
添加此配置：
{
"mcpServers": {
"travel-planner": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"YOUR_DOCKERHUB_USERNAME/travel-planner-mcp:latest"
]
}
}
}
- 重新启动克劳德桌面
🔧 开发设置
# Create virtual environment
/opt/homebrew/bin/python3.12 -m venv .venv
source .venv/bin/activate
# Install dependencies
uv add "mcp[cli]" httpx anthropic
# Run server
python src/travel_planner/server.py
📚 用法示例
- “接下来5天巴黎的天气怎么样？”
- “查找罗马的旅游景点”
- “为东京制定一个以传统文化为重点的4天行程”
- “从伦敦到爱丁堡有多远？”
API密钥
使用免费API（无需密钥！）
- 开放气象API：天气预报
- 开放街道地图/提名：地理编码和位置数据
- 天桥API：兴趣点搜索
所有工具都可以在没有任何API密钥的情况下工作！
🛠️ 技术细节
技术
- 语言：Python 3.12+
- 框架：FastMCP（模型上下文协议）
- 容器化：Docker
- 应用程序编程接口：httpx用于异步HTTP请求
- 外部服务：全部免费，无需身份验证
工具规格
- get_weather_forecast：Open Meteo的实时天气数据
- 搜索位置：使用OpenStreetMap/Overpass查找景点
- 生成行程：基于模板的行程生成器（不需要AI密钥）
- 计算旅行距离：Haversine距离计算
