🚀 携程旅游规划助手 MCP 服务器

携程旅游规划助手 MCP 服务器提供对携程数据的访问权限，可用于规划假期、查找景点、餐厅和酒店，为用户的旅行提供便利。

🚀 快速开始

功能概述

本服务器具备以下实用功能：

• 🔍 按名称和类别搜索位置
• 📋 获取特定位置的详细信息
• 🌟 查找附近的景点、餐厅和酒店
• 📷 查看照片和评论
• 💡 互动式旅游规划提示

📦 安装指南

先决条件

• Python 3.10 或更高版本
• uv - 快速的 Python 包安装程序和解析器
• 携程 API 密钥（从 携程开发人员门户 获取）
• Claude Desktop
• Google Maps MCP 服务器（请参见 GitHub）

使用 uv 进行安装

1. 克隆此仓库。
2. 创建并激活虚拟环境：

   uv venv
   # 在 Windows 上
   .venv\Scripts\activate
   # 在 macOS/Linux 上
   source .venv/bin/activate
   

3. 安装所需的依赖项：

   uv add "mcp[cli]"
   

运行服务器

可以直接运行服务器：

# 将 API 密钥设置为环境变量
export CTRIP_API_KEY=your_api_key_here  # Linux/macOS
set CTRIP_API_KEY=your_api_key_here     # Windows 命令提示符
$env:CTRIP_API_KEY="your_api_key_here"  # Windows PowerShell

# 运行服务器
mcp run server.py

在 Claude Desktop 上设置

使用以下命令安装 MCP 服务器：

mcp install server.py

配置 Claude Desktop

1. 打开 Claude Desktop。
2. 转到 设置 > MCP 服务器。
3. 添加一个新的服务器配置，如下所示：

   {
     "ctrip": {
       "command": "uv",
       "args": [
         "run",
         "--with",
         "mcp[cli]",
         "mcp",
         "run",
         "PATH_TO_YOUR_PROJECT\\server.py"
       ],
       "env": {
         "CTRIP_API_KEY": "YOUR_API_KEY_HERE"
       }
     }
   }
   

4. 将 PATH_TO_YOUR_PROJECT 替换为您的项目目录的绝对路径。
5. 将 YOUR_API_KEY_HERE 替换为您实际的携程 API 密钥。

使用旅游规划助手

1. 在 Claude 中启动一个新的对话。
2. 用“旅游规划助手”提示词开始任何提示。
3. 按照互动提示规划您的完美假期！

📚 详细文档

所使用的 API 端点

• 地理位置搜索：按名称和类别查找地理位置
• 地理位置详细信息：获取地理位置的全面信息
• 地理位置照片：查看地理位置的照片
• 地理位置评论：阅读地理位置的评论
• 附近搜索：查找特定点附近的地理位置

🔧 技术细节

故障排除

• ⚠️ 如果看到 401 未经授权错误，请检查您的 API 密钥是否正确，并确保在携程开发人员门户中 whitelist 您的 IP 地址。
• ⚠️ 对于 Claude Desktop 集成问题，验证您的配置设置，并确保 server.py 的路径是正确的。
• ⚠️ 如果 Claude 无法完成，则很有可能是输入令牌过多。get_location_details_tool 通常是罪魁祸首。